gdm module

class gdm.Gdm

Bases: object

This module can control GDM-8261A、GDM-906X.

It supports USB interface to use SCPI.

It will scan available instruments on your DSO, then require a serial number to specify and connect to it.

Usage:

import gdm
inst = gdm.Gdm()
inst.connect('<Instrument Serial Number>')
print(inst.idn())
inst.close()
abort() None

Aborts a measurement in progress, returning the instrument to the trigger idle state.

clear_all_calculations() None

Clears all of the compare results, statistic calculation value, histogram calculation value, and measurement value. (For GDM-906X)

clear_compare_results() None

Clears compare function result counts. (For GDM-906X)

clear_statistic_values() None

Clears all of the statistic calculation values. (For GDM-906X)

close() None

Close the connection.

configure_4W_resistance(disp: int = 1, range: str | None = None, res: str | None = None, auto_range: str | None = None, nplc: str | None = None) None

Sets measurement to 4W Resistance on the specified display (either the first or second) and specify the range/resolution.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Resistance range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

  • auto_range (str, optional) – Auto-range setting. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’.

  • nplc (str, optional) –

    Integration time in PLCs. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a specific numeric value. For any numeric value, the DMM will automatically set the PLC to the closest acceptable value. The acceptable PLC values are:

    • GDM-8261A: 0.025, 0.1, 0.25, 1, 2, 12.

    • GDM-906X: 0.006, 0.0083, 0.0125, 0.025, 0.05, 0.15, 0.6, 1, 3, 12.

configure_ACI(disp: int = 1, range: str | None = None, res: str | None = None, auto_range: str | None = None) None

Sets measurement to AC Current on the specified display (either the first or second) and specify the range/resolution.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Current range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

  • auto_range (str, optional) – AC current auto-range setting. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’.

configure_ACV(disp: int = 1, range: str | None = None, res: str | None = None, auto_range: str | None = None) None

Sets measurement to AC Voltage on the specified display (either the first or second) and specify the range/resolution.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Voltage range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

  • auto_range (str, optional) – AC voltage auto-range setting. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’.

configure_DCI(disp: int = 1, range: str | None = None, res: str | None = None, auto_range: str | None = None, nplc: str | None = None) None

Sets measurement to DC Current on the specified display (either the first or second) and specify the range/resolution.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Current range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

  • auto_range (str, optional) – DC current auto-range setting. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’.

  • nplc (str, optional) –

    Integration time in PLCs. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a specific numeric value. For any numeric value, the DMM will automatically set the PLC to the closest acceptable value. The acceptable PLC values are:

    • GDM-8261A: 0.025, 0.1, 0.25, 1, 2, 12.

    • GDM-906X: 0.006, 0.0083, 0.0125, 0.025, 0.05, 0.15, 0.6, 1, 3, 12.

configure_DCV(disp: int = 1, range: str | None = None, res: str | None = None, auto_range: str | None = None, nplc: str | None = None, auto_imp: str | None = None) None

Sets measurement to DC Voltage on the specified display (either the first or second) and specify the range/resolution.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Voltage range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

  • auto_range (str, optional) – DC voltage auto-range setting. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’.

  • nplc (str, optional) –

    Integration time in PLCs. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a specific numeric value. For any numeric value, the DMM will automatically set the PLC to the closest acceptable value. The acceptable PLC values are:

    • GDM-8261A: 0.025, 0.1, 0.25, 1, 2, 12.

    • GDM-906X: 0.006, 0.0083, 0.0125, 0.025, 0.05, 0.15, 0.6, 1, 3, 12.

  • auto_imp (str, optional) – Automatic input impedance. Acceptable values include 0, 1, ‘ON’ or ‘OFF’. (For GDM-906X)

configure_DCV_ratio(range: str | None = None, res: str | None = None) None

Sets measurement to DCV ratio mode on the 1st display and specifies range/resolution.

Parameters:
  • range (str, optional) – Voltage range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

configure_FRTD(sensor: str = '', alpha: float | None = None, beta: float | None = None, delta: float | None = None, res: str | None = None, R0: str | None = None) None

Sets measurement to 4W RTD on the first display and specifies sensor type, along with related coefficients.

Parameters:
  • sensor (str, optional) – RTD Type, one of ‘PT100’, ‘D100’, ‘F100’, ‘PT385’, ‘PT3916’, or ‘USER’.

  • alpha (float, optional) – RTD Alpha coefficient, range is 0 to 10, default value is 0.00385.

  • beta (float, optional) – RTD BETA coefficient, range is 0 to 10, default value is 0.10863.

  • delta (float, optional) – RTD DELTa coefficient, range is 0 to 10, default value is 1.49990.

  • res (str, optional) – 4W RTD resolution. Acceptable values include ‘MIN’, ‘MAX’, or a specific numeric value.

  • R0 (str, optional) – Reference resistance (R0) of 4-wire RTD measurement. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a specific numeric value (80.0~120.0). (For GDM-906X)

configure_RTD(sensor: str = '', alpha: float | None = None, beta: float | None = None, delta: float | None = None, res: str | None = None, R0: str | None = None) None

Sets measurement to 2W RTD on the first display and specifies sensor type, along with related coefficients.

Parameters:
  • sensor (str, optional) – RTD Type, one of ‘PT100’, ‘D100’, ‘F100’, ‘PT385’, ‘PT3916’, or ‘USER’.

  • alpha (float, optional) – RTD Alpha coefficient, range is 0 to 10, default value is 0.00385.

  • beta (float, optional) – RTD BETA coefficient, range is 0 to 10, default value is 0.10863.

  • delta (float, optional) – RTD DELTa coefficient, range is 0 to 10, default value is 1.49990.

  • res (str, optional) – 2W RTD resolution. Acceptable values include ‘MIN’, ‘MAX’, or a specific numeric value.

  • R0 (str, optional) – Reference resistance (R0) of 2-wire RTD measurement. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a specific numeric value (80.0~120.0). (For GDM-906X)

configure_TCUP(sensor: str = '', rjunction: float | None = None, res: str | None = None) None

Sets measurement to Temperature thermocouple (T-CUP) on the first display and specifies sensor type, along with related coefficients.

Parameters:
  • sensor (str, optional) – Thermocouple type, one of ‘B’, ‘E’, ‘J’, ‘K’, ‘N’, ‘R’, ‘S’, or ‘T’.

  • rjunction (float, optional) – Simulated junction temperature value (0.00 ~ 50.00), default value is 23.00.

  • res (str, optional) – Thermocouple resolution. Acceptable values include ‘MIN’, ‘MAX’, or a specific numeric value.

configure_capacitance(range: str | None = None, auto_range: str | None = None, calibrate: bool = False) None

Sets measurement to Capacitance on the 1st display and specify the range. (For GDM-906X)

Parameters:
  • range (str, optional) – Voltage range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • auto_range (int or str, optional) – Auto-range setting for the capacitance measurement. Acceptable values include 0, 1, ‘ON’, ‘OFF’, ‘ONCE’.

  • calibrate (bool, optional) – If True, perform calibration before measurement. Only valid for 1nF and 10nF ranges.

configure_continuity(thr: int = 10, res: str | None = None, nplc: str | None = None, trig_delay: str | None = None, auto_zero: str | None = None) None

Sets measurement to Continuity on the first display and specifies the related parameters.

Parameters:
  • thr (int) – Continuity threshold in ohms, 0 ~ 1000.

  • res (str, optional) – Continuity measurement resolution. Acceptable values include a numeric value, ‘MIN’, ‘MAX’, or ‘DEF’ (DEF is for GDM-906X).

  • nplc (str, optional) – Integration time in PLCs (power line cycles). Acceptable values include a numeric value, ‘MIN’, ‘MAX’, or ‘DEF’. (For GDM-906X)

  • trig_delay (str, optional) – Trigger delay that minimum step is microseconds. Acceptable values include a numeric value, ‘MIN’, ‘MAX’, or ‘DEF’. (For GDM-906X)

  • auto_zero (int or str, optional) – Auto zero mode. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’. (For GDM-906X)

configure_diode(res: str | None = None, nplc: str | None = None, trig_delay: str | None = None, auto_zero: str | None = None) None

Sets measurement to Diode on the first display and specifies the related parameters.

Parameters:
  • res (str, optional) – Diode measurement resolution. Acceptable values include a numeric value, ‘MIN’, or ‘MAX’’, or ‘DEF’ (DEF is for GDM-906X).

  • nplc (str, optional) – Integration time in PLCs (power line cycles). Acceptable values include a numeric value, ‘MIN’, ‘MAX’, or ‘DEF’. (For GDM-906X)

  • trig_delay (str, optional) – Trigger delay that minimum step is microseconds. Acceptable values include a numeric value (0 ~ 3600 s), ‘MIN’, ‘MAX’, or ‘DEF’. (For GDM-906X)

  • auto_zero (int or str, optional) – Auto zero mode. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’. (For GDM-906X)

configure_disp2_off() None

Turns the second display function off.

configure_frequency(disp: int = 1, range: str | None = None, res: str | None = None, gtimer: float | None = None, injack: int | None = None, volt_range: str | None = None, vrange_auto: str | None = None, curr_range: str | None = None, crange_auto: str | None = None) None

Sets measurement to Frequency on the specified display (either the first or second) and specify the range/resolution.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

  • gtimer (float, optional) – Aperture time (gate time). Acceptable values are 0.01 for FAST, 0.1 for MID, or 1 for SLOW.

  • injack (int, optional) – Input port. For GDM-8261A, acceptable values are 0 for volt, 1 for 1A, or 2 for 10A. For GDM-906X, acceptable values are 0 for Voltage, 1 for 3A, or 2 for 10A.

  • volt_range (str, optional) – Voltage range for the frequency measurement. Acceptable values include a specific numeric value, ‘MIN’, ‘MAX’, or ‘DEF’.

  • vrange_auto (str, optional) – Auto-range setting for voltage range. Acceptable values are 0, 1, ‘ON’, ‘OFF’, ‘ONCE’.

  • curr_range (str, optional) – Current range for the frequency measurement. Acceptable values include a specific numeric value, ‘MIN’, ‘MAX’, or ‘DEF’. (For GDM-906X)

  • crange_auto (str, optional) – Auto-range setting for current range. Acceptable values are 0, 1, ‘ON’, ‘OFF’, ‘ONCE’. (For GDM-906X)

configure_period(disp: int = 1, range: str | None = None, res: str | None = None, gtimer: float | None = None, injack: int | None = None, volt_range: str | None = None, vrange_auto: str | None = None, curr_range: str | None = None, crange_auto: str | None = None) None

Sets measurement to Period on the specified display (either the first or second) and specify the range/resolution.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Voltage range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

  • gtimer (float, optional) – Aperture time (gate time). Acceptable values are 0.01 for FAST, 0.1 for MID, or 1 for SLOW.

  • injack (int, optional) – Input port. Acceptable values are 0 for volt, 1 for 1A, or 2 for 10A.

  • volt_range (str, optional) – Voltage range for the period measurement. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a specific numeric value.

  • vrange_auto (str, optional) – Auto-range setting for voltage range. Acceptable values are 0, 1, ‘ON’, ‘OFF’, ‘ONCE’.

  • curr_range (str, optional) – Current range for the period measurement. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a specific numeric value. (For GDM-906X)

  • crange_auto (str, optional) – Auto-range setting for current range. Acceptable values are 0, 1, ‘ON’, ‘OFF’, ‘ONCE’. (For GDM-906X)

configure_resistance(disp: int = 1, range: str | None = None, res: str | None = None, auto_range: str | None = None, nplc: str | None = None) None

Sets measurement to 2W Resistance on the specified display (either the first or second) and specify the range/resolution.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Resistance range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

  • auto_range (str, optional) – Auto-range setting for 2-wire resistance. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’.

  • nplc (str, optional) –

    Integration time in PLCs. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a specific numeric value. For any numeric value, the DMM will automatically set the PLC to the closest acceptable value. The acceptable PLC values are:

    • GDM-8261A: 0.025, 0.1, 0.25, 1, 2, 12.

    • GDM-906X: 0.006, 0.0083, 0.0125, 0.025, 0.05, 0.15, 0.6, 1, 3, 12.

configure_temperature(probe: str | None = None, sensor: str | None = None, res: str | None = None, nplc: str | None = None) None

Sets measurement to Temperature on the 1st display and specifies type/resolution. (For GDM-906X)

Parameters:
  • probe (str, optional) – probe type, one of ‘TCOuple’, ‘RTD’, ‘FRTD’, ‘THERmistor’, ‘FTHermistor’.

  • sensor (str, optional) – Sensor type, varies based on the probe type. TCOuple: ‘J’, ‘K’, ‘N’, ‘R’, ‘S’, ‘T’, ‘B’, ‘E’, ‘USER’ RTD / FRTD: ‘PT100’, ‘D100’, ‘F100’, ‘PT385’, ‘PT3916’, ‘USER’ Thermistor / Fthermistor: ‘2.2kΩ’, ‘5kΩ’, ‘10kΩ’, ‘USER’

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

  • nplc (str, optional) – Integration time in PLCs. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a specific numeric value (1, 3, or 12).

connect(SN: str, baudrate: int = 9600, timeout: int = 3) int

Connect to the gdm.

Parameters:
  • SN (str) – Serial Number is necessary.

  • baudrate (int, optional) – baudrate. Defaults to 9600.

  • timeout (int, optional) – timeout. Defaults to 3.

Returns:

0 or -1

Return type:

int

err() str
get_advanced_measurement() str

Returns the current Advanced function.

Returns:

Current advanced measurement.

Return type:

measurement (str)

get_advanced_state() str

Returns the status of the Advanced function.

Returns:

Advanced function status, either ‘ON’ or ‘OFF’.

Return type:

status (str)

get_auto_range(disp: int = 1) bool

Returns the Auto-Range status of the function on the specified display.

Parameters:

disp (int) – Display number (1 or 2).

Returns:

True if the current status is Auto range, False if the current status is Manual range.

Return type:

status (bool)

get_average_count(function: int = 2) int

Returns the total number of recorded counts. (For GDM-8261A)

Parameters:
  • function (int, optional) – Function for the count query, 0 for Store, 1 for Scan (Route), or 2 for Stats.

  • provided (If not) –

  • 2 (defaults to) –

Returns:

Total number of counts.

Return type:

int

get_average_maximum(function: int = 2) float

Returns the maximum recorded value. (For GDM-8261A)

Parameters:
  • function (int, optional) – Function for the query, 0 for Store, 1 for Scan (Route), or 2 for Stats.

  • provided (If not) –

  • 2 (defaults to) –

Returns:

Maximum recorded value.

Return type:

float

get_average_minimum(function: int = 2) float

Returns the minimum recorded value. (For GDM-8261A)

Parameters:
  • function (int, optional) – Function for the query, 0 for Store, 1 for Scan (Route), or 2 for Stats.

  • provided (If not) –

  • 2 (defaults to) –

Returns:

Minimum recorded value.

Return type:

float

get_average_ptp(function: int = 2) float

Returns the recorded peak-to-peak value (max value – min value). (For GDM-8261A)

Parameters:
  • function (int, optional) – Function for the query, 0 for Store, 1 for Scan (Route), or 2 for Stats.

  • provided (If not) –

  • 2 (defaults to) –

Returns:

Peak-to-peak recorded value.

Return type:

float

get_average_sdev(function: int = 2) float

Returns the recorded Standard Deviation. (For GDM-8261A)

Parameters:
  • function (int, optional) – Function for the query, 0 for Store, 1 for Scan (Route), or 2 for Stats.

  • provided (If not) –

  • 2 (defaults to) –

Returns:

Recorded Standard Deviation.

Return type:

float

get_average_value(function: int = 2) float

Returns the average recorded value. (For GDM-8261A)

Parameters:
  • function (int, optional) – Function for the query, 0 for Store, 1 for Scan (Route), or 2 for Stats.

  • provided (If not) –

  • 2 (defaults to) –

Returns:

Average recorded value.

Return type:

float

get_compare_fail_counts() tuple

Returns the low and high fail count of the compare function. (For GDM-906X)

Returns:

A tuple containing two integers, the low fail count and the high fail count.

Return type:

tuple

get_compare_lower_limit() float

Returns the lower limit of the compare function.

Returns:

The lower limit value.

Return type:

float

get_compare_upper_limit() float

Returns the upper limit of the compare function.

Returns:

The upper limit value.

Return type:

float

get_db_reference() float

Returns the reference voltage from the dB function.

Returns:

The reference voltage value.

Return type:

float

get_dbm_reference() float

Returns the resistance value from the dBm function.

Returns:

Resistance value.

Return type:

float

get_function(disp: int = 1) str

Returns the current function on the specified display.

Parameters:

disp (int) – Display number (1 or 2).

Returns:

For display 1: One of ‘VOLT’, ‘VOLT:AC’, ‘CURR’, ‘CURR:AC’, ‘RES’, ‘FRES’,

’FREQ’, ‘PER’, ‘TEMP:RTD’, ‘TEMP:FRTD’, ‘TEMP:TCO’, ‘DIOD’, ‘CONT’.

For display 2: One of ‘VOLT’, ‘VOLT:AC’, ‘CURR’, ‘CURR:AC’, ‘RES’, ‘FRES’,

’FREQ’, ‘PER’, ‘NON’.

Return type:

current function (str)

get_math_b_offset() float

Returns the offset factor B used in the math measurement.

Returns:

Offset factor B.

Return type:

float

get_math_m_factor() float

Returns the scale factor M used in the math measurement.

Returns:

Scale factor M.

Return type:

float

get_math_percent() float

Returns the reference value setting for the Percent function.

Returns:

Reference value.

Return type:

float

get_maximum_measurement() float

Returns the maximum value from the Max/Min measurement.

Returns:

Maximum value.

Return type:

float

get_minimum_measurement() float

Returns the minimum value from the Max/Min measurement.

Returns:

Minimum value.

Return type:

float

get_range(disp: int = 1) str

Returns the current range on the specified display.

Parameters:

disp (int) – Display number (1 or 2).

Returns:

For DCV: 0.1(100mV), 1(1V), 10(10V), 100(100V), 1000(1000V). For ACV: 0.1(100mV), 1(1V), 10(10V), 100(100V), 750(750V). For ACI: 0.001(1mA), 0.01(10mA), 0.1(100mA), 1(1A), 10(10A). For DCI: 0.0001(100μA), 0.001(1mA), 0.01(10mA), 0.1(100mA), 1(1A), 10(10A) for disp 1,

or 0.001(1mA), 0.01(10mA), 0.1(100mA), 1(1A), 10(10A) for disp 2.

For RES: 10E+1(100Ω) 10E+2(1kΩ), 10E+3(10kΩ), 10E+4 (100kΩ), 10E+5(1MΩ), 10E+6(10MΩ), 10E+7(100MΩ). NONE: Indicates that the second display is not active.

Return type:

range (str)

get_relative_reference() float

Returns the reference value from the relative function. (For GDM-8261A)

Returns:

Reference value.

Return type:

reference (float)

get_statistic_STDEV() float

Returns the Standard Deviation value. (For GDM-906X)

Returns:

The Standard Deviation value.

Return type:

float

get_statistic_average() float

Returns the average value. (For GDM-906X)

Returns:

The Average value.

Return type:

float

get_statistic_count() float

Returns the total count of statistics. (For GDM-906X)

Returns:

The total count of statistics.

Return type:

float

get_statistic_maximum() float

Returns the maximum value. (For GDM-906X)

Returns:

The maximum value.

Return type:

float

get_statistic_minimum() float

Returns the minimum value. (For GDM-906X)

Returns:

The minimum value.

Return type:

float

get_statistic_peak_to_peak() float

Returns the peak to peak value (max value – min value). (For GDM-906X)

Returns:

The peak to peak value.

Return type:

float

get_store_count() int

Returns the number of counts that are recorded with the Store measurement function. (For GDM-8261A)

Returns:

Number of counts.

Return type:

int

get_uncalculated_data() str

Returns uncalculated original measurement. (For GDM-906X)

idn() str
initiate() None

Changes the state of the triggering system from “idle” to “wait-for-trigger”, and clears the previous set of measurements from reading memory.

local_control() None

Enables local control (front panel control) and disables remote control.

measure_4W_resistance(disp: int = 1, range: str | None = None, res: str | None = None) float

Returns the 4W resistance measurement on the specified display.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Resistance range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

Returns:

4W resistance value.

Return type:

resistance (float)

measure_ACI(disp: int = 1, range: str | None = None, res: str | None = None) float

Returns the AC current measurement on the specified display.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Current range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

Returns:

AC current value.

Return type:

ACI (float)

measure_ACV(disp: int = 1, range: str | None = None, res: str | None = None) float

Returns the AC voltage measurement on the specified display.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Voltage range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

Returns:

AC voltage value.

Return type:

ACV (float)

measure_DCI(disp: int = 1, range: str | None = None, res: str | None = None) float

Returns the DC current measurement on the specified display.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Current range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

Returns:

DC current value.

Return type:

DCI (float)

measure_DCV(disp: int = 1, range: str | None = None, res: str | None = None) float

Returns the DC voltage measurement on the specified display.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Voltage range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

Returns:

DC voltage value.

Return type:

DCV (float)

measure_DCV_ratio(range: str | None = None, res: str | None = None) float

Returns the DC ratio measurement on the 1st display.

Parameters:
  • range (str, optional) – Voltage range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

Returns:

DC ratio value.

Return type:

DC ratio (float)

measure_FRTD(sensor: str = '') float

Returns the 4W RTD temperature for the selected sensor type on the first display.

Parameters:

sensor (str, optional) – RTD Type, one of ‘PT100’, ‘D100’, ‘F100’, ‘PT385’, ‘PT3916’, or ‘USER’.

Returns:

Temperature value.

Return type:

temperature (float)

measure_RTD(sensor: str = '') float

Returns the 2W RTD temperature for the selected sensor type on the first display.

Parameters:

sensor (str, optional) – RTD Type, one of ‘PT100’, ‘D100’, ‘F100’, ‘PT385’, ‘PT3916’, or ‘USER’.

Returns:

Temperature value.

Return type:

temperature (float)

measure_TCUP(sensor: str = '') float

Returns the temperature for the selected thermocouple type on the first display.

Parameters:

sensor (str, optional) – Thermocouple type, one of ‘B’, ‘E’, ‘J’, ‘K’, ‘N’, ‘R’, ‘S’, or ‘T’.

Returns:

Temperature value.

Return type:

temperature (float)

measure_capacitance(range: str | None = None) float

Returns the capacitance measurement value on the 1st display. (For GDM-906X)

Parameters:

range (str, optional) – Capacitance range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

Returns:

Capacitance measurement value.

Return type:

capacitance (float)

measure_continuity() float

Returns the continuity measurement on the first display.

Returns:

Continuity in ohms.

Return type:

continuity (float)

measure_diode() float

Returns the diode measurement on the first display.

Returns:

Diode voltage value.

Return type:

diode (float)

measure_frequency(disp: int = 1, range: str | None = None, res: str | None = None) float

Returns the frequency measurement on the specified display.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

Returns:

Frequency value.

Return type:

frequency (float)

measure_period(disp: int = 1, range: str | None = None, res: str | None = None) float

Returns the period measurement on the specified display.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Voltage range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

Returns:

Period value.

Return type:

period (float)

measure_resistance(disp: int = 1, range: str | None = None, res: str | None = None) float

Returns the 2W resistance measurement on the specified display.

Parameters:
  • disp (int) – Display number, 1 for the first display, 2 for the second display.

  • range (str, optional) – Resistance range for the measurement. Acceptable values include ‘AUTO’, ‘DEF’ (both for autoranging), ‘MIN’, ‘MAX’, or a specific numeric value.

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

Returns:

2W resistance value.

Return type:

resistance (float)

measure_temperature(probe: str | None = None, sensor: str | None = None, res: str | None = None) float

Returns the temperature measurement value with the selected probe and type on the 1st display. (For GDM-906X)

Parameters:
  • probe (str, optional) – Probe type, one of ‘TCO’, ‘RTD’, ‘FRTD’, ‘THER’, ‘FTH’.

  • sensor (str, optional) – Sensor type, varies based on the probe type. TCOuple: ‘J’, ‘K’, ‘N’, ‘R’, ‘S’, ‘T’, ‘B’, ‘E’ RTD / FRTD: ‘PT100’, ‘D100’, ‘F100’, ‘PT385’, ‘PT3916’, ‘USER’ THERmistor / FTHermistor: ‘2.2kΩ’, ‘5kΩ’, ‘10kΩ’, ‘USER’

  • res (str, optional) – Resolution for the measurement. Acceptable values include ‘DEF’ for default setting value, ‘MIN’, ‘MAX’, or a specific numeric value.

Returns:

Temperature measurement value.

Return type:

Temperature (float)

opc() int
query(cmd: str) str

Send a query SCPI command to the instrument and return the result.

Parameters:

cmd (str) – SCPI command to be queried.

Returns:

Result of the SCPI command.

Return type:

str

read_display_value(disp: int = 1) list

Returns the display values based on the specified display.

Parameters:

disp (int) – Display number, 1 for the first display, 2 for the second display.

Returns:

The measured values from the specified display.

Return type:

list

readline() str

Read a line from the instrument’s communication port and return it as a string.

Returns:

The string read from the instrument.

Return type:

str

scpi_delay

SCPI delay.

set_4W_resistance_sense(rel_stat: str | None = None, rel_val: str | None = None, rel_val_auto: str | None = None, trig_delay: str | None = None, auto_zero: str | None = None) None

Sets the sense parameters for 4-wire resistance measurement. (For GDM-906X)

Parameters:
  • rel_stat (str, optional) – Relative function state. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • rel_val (str, optional) – Relative value. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (-120.0 ~ 120.0 MΩ).

  • rel_val_auto (str, optional) – Relative value auto on/off. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • trig_delay (str, optional) – Trigger delay time. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0 ~ 3600 s). Minimum step is microseconds.

  • auto_zero (str, optional) – Auto zero mode. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’.

set_ACI_sense(bandwidth: str | None = None, rel_stat: str | None = None, rel_val: float | None = None, rel_val_auto: str | None = None, terminals: int | None = None, trig_delay: str | None = None) None

Sets the sense parameters for AC Current measurement. (For GDM-906X)

Parameters:
  • bandwidth (str, optional) – AC current bandwidth setting. Acceptable values include 3, 20, 200, ‘MIN’, ‘MAX’, or ‘DEF’.

  • rel_stat (str, optional) – Relative function state. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • rel_val (str, optional) – Relative value. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (-12.0 to 12.0 A).

  • rel_val_auto (str, optional) – Relative value auto on/off. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • terminals (int, optional) – Input port for the current function. Acceptable values include 3 or 10 (depending on the model, GDM-9060 : 3 / GDM-9061 : 3 | 10).

  • trig_delay (str, optional) – Trigger delay time. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0 ~ 3600 s). Minimum step is microseconds.

set_ACV_sense(bandwidth: float | None = None, rel_stat: str | None = None, rel_val: float | None = None, rel_val_auto: str | None = None, trig_delay: str | None = None, auto_zero: str | None = None) None

Sets the sense parameters for AC Voltage measurement. (For GDM-906X)

Parameters:
  • bandwidth (float, optional) – AC bandwidth setting. Acceptable values include 3, 20, 200, ‘MIN’, ‘MAX’, or ‘DEF’.

  • rel_stat (str, optional) – Relative function state. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • rel_val (str, optional) – Relative value. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (-1200.0 to 1200.0 V).

  • rel_val_auto (str, optional) – Relative value auto on/off. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • trig_delay (str, optional) – Trigger delay time. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0 ~ 3600 s). Minimum step is microseconds.

set_DCI_sense(rel_stat: str | None = None, rel_val: float | None = None, rel_val_auto: str | None = None, terminals: int | None = None, trig_delay: str | None = None, auto_zero: str | None = None) None

Sets the sense parameters for DC Current measurement. (For GDM-906X)

Parameters:
  • rel_stat (str, optional) – Relative function state. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • rel_val (str, optional) – Relative value. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (-12.0 to 12.0 A).

  • rel_val_auto (str, optional) – Relative value auto on/off. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • terminals (int, optional) – Input port for the current function. Acceptable values include 3 or 10 (depending on the model, GDM-9060 : 3 / GDM-9061 : 3 | 10).

  • trig_delay (str, optional) – Trigger delay time. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0 ~ 3600 s). Minimum step is microseconds.

  • auto_zero (str, optional) – Auto zero mode. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’.

set_DCV_sense(rel_stat: str | None = None, rel_val: float | None = None, rel_val_auto: str | None = None, trig_delay: str | None = None, auto_zero: str | None = None) None

Sets the sense parameters for DC Voltage measurement. (For GDM-906X)

Parameters:
  • rel_stat (str, optional) – Relative function state. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • rel_val (str, optional) – Relative value. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (-1200.0 to 1200.0 V).

  • rel_val_auto (str, optional) – Relative value auto on/off. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • trig_delay (str, optional) – Trigger delay time. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0 ~ 3600 s). Minimum step is microseconds.

  • auto_zero (str, optional) – Auto zero mode. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’.

set_TCUP_sense(sim_val: str | None = None, sim_auto: str | None = None, sim_auto_offset: str | None = None) None

Sets the thermocouple simulation parameters for Temperature measurement. (For GDM-906X)

Parameters:
  • sim_val (str, optional) – Thermocouple junction simulation temperature value. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (-20.00 to 80.00).

  • sim_auto (str, optional) – Auto junction reference temperature. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • sim_auto_offset (str, optional) – Junction reference temperature adjust value. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (-20.00 to 20.00).

set_ac_bandwidth(bandwidth: int | None = None) None

Sets the AC bandwidth (AC filter).

Parameters:

bandwidth (int) – AC bandwidth. Acceptable values are 3, 20, or 200.

set_advanced_measurement(measurement: str | None = None) None

Sets the Advanced function.

Parameters:

measurement (str) – Advanced measurement. For GDM-8261A: one of ‘OFF’, ‘MIN’, ‘MAX’, ‘HOLD’, ‘REL’, ‘COMP’, ‘DB’, ‘DBM’, ‘STORE’, ‘AVER’, ‘MXB’, ‘INV’, ‘REF’. For GDM-906X: one of ‘OFF’, ‘HOLD’, ‘DB’, ‘DBM’, ‘LIM’, ‘MXB’, ‘INV’, ‘REF’.

set_advanced_state(state: str | None = None) None

Turns the Advanced function on/off.

Parameters:

state (str) – Advanced function state, either ‘ON’ or ‘OFF’.

set_analog_filter(state: str | None = None) None

Turns the analog filter On/Off. (For GDM-8261A)

Parameters:

state (str) – Filter state, ‘ON’ or ‘OFF’.

set_auto_gain(mode: str | None = None) None

Sets the Auto gain mode to on, off or once only. (For GDM-8261A)

Parameters:

mode (str) – Auto gain mode, one of ‘ON’, ‘OFF’, or ‘ONCE’.

set_auto_input_impedance(auto_imp: str | None = None) None

Sets the Automatic input impedance for DCV mode.

Parameters:

auto_imp (str) – Automatic input impedance. Acceptable values include ‘ON’ or ‘OFF’.

set_auto_range(disp: int = 1, state: str | None = None) None

Sets Auto-Range on or off on the specified display.

Parameters:
  • disp (int) – Display number (1 or 2).

  • state (str) – ‘ON’ or ‘OFF’.

set_auto_zero(mode: str | None = None) None

Sets the Auto zeroing mode to on, off or once only. (For GDM-8261A)

Parameters:

mode (str) – Auto zero mode, one of ‘ON’, ‘OFF’, or ‘ONCE’.

set_average_count(count: int | None = None) None

Sets the total number of statistic counts for Statistics Calculations (Analyze Stats). (For GDM-8261A)

Parameters:

count (int) – Number of counts, 0 for continuous count, or an integer value between 2 and 100000.

set_compare_parameters(lower_limit: str | None = None, upper_limit: str | None = None, beeper: str | None = None) None

Sets the lower and upper limits and the beeper alarm mode of the compare function.

Parameters:
  • lower_limit (str) – Lower limit value, one of a float number, ‘MIN’, or ‘MAX’.

  • upper_limit (str) – Upper limit value, one of a float number, ‘MIN’, or ‘MAX’.

  • beeper (str) – Beeper alarm mode, one of ‘OFF’, ‘PASS’, or ‘FAIL’. (For GDM-906X)

set_compare_state(state: str | None = None) None

Sets the status on/off for the compare function. (For GDM-906X)

Parameters:

state (int or str) – Status of the compare function, one of 0, 1, ‘ON’, ‘OFF’.

set_current_auto_detect(mode: str | None = None) None

Sets the current auto-detect mode on or off for the current functions. (For GDM-8261A)

Parameters:

mode (str) – Current auto-detect, ‘ON’ or ‘OFF’.

set_db_reference(reference: str | None = None, method: str | None = None) None

Sets the reference value and the method for the dB function.

Parameters:
  • reference (str) –

    Reference value, one of ‘MIN’, ‘MAX’, or a numeric value. RefMethod:

    Voltage: (-1200 ~ 1200 V) dBm: (-200.0 ~ 200 dBm)

  • method (str) – Method for the reference value, one of ‘VOLTage’ or ‘DBM’. (For GDM-906X)

set_db_reference_auto(auto: str | None = None) None

Sets the first measurement as the reference value for dB measurement.

Parameters:

auto (int or str) – Auto reference setting, one of 0, 1, ‘ON’, ‘OFF’.

set_dbm_reference(reference: str | None = None) None

Sets the resistance value for the dBm function.

Parameters:

reference (str) – Reference value. For GDM-8261A: one of ‘MIN’, ‘MAX’, or a numeric value. For GDM-906X: one of ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value in the range of (2, 4, 8, 16, 50, 75, 93, 110, 124, 125, 135, 150, 250, 300, 500, 600, 800, 900, 1000, 1200, 8000).

set_digital_filter(disp: int = 1, type: str | None = None, count: str | None = None, window: str | None = None, method: str | None = None, state: str | None = None) None

Sets the digital filter parameters.

Parameters:
  • disp (int, optional) – Display number, 1 for the first display, 2 for the second display (2 for GDM-9261A).

  • type (str, optional) – Filter type, One of ‘MOV’ for moving (default), ‘REP’ for repeating.

  • count (str, optional) – Filter count a number between 2 and 100, or ‘MIN’ or ‘MAX’. For GDM-9261A, ‘DEF’ is also valid.

  • window (float or str, optional) – Filter window, one of 0.01, 0.1, 1, 10, or ‘NONE’.

  • method (str, optional) – Filter window method, ‘Measure’ or ‘Range’ (For GDM-9261A).

  • state (str, optional) – Filter state, ‘ON’ or ‘OFF’. For GDM-9261A, 0 or 1 is also valid.

set_digital_shift(mode: str = 'ON') None

Sets the Digital Shift function on or off.

Parameters:

mode (str) – D-Shift, ‘ON’ or ‘OFF’. Defaults to ‘ON’.

set_display_view(view_mode: str | None = None) None

Sets the display form of the measured value.

Parameters:

view_mode (str) – Display form, one of ‘NUM’ (NUMeric), ‘HIST’ (HISTogram), ‘TCH’ (TCHart), or ‘MET’ (METer).

set_frequency_sense(rel_stat: str | None = None, rel_val: str | None = None, rel_val_auto: str | None = None, timeout_auto: str | None = None, trig_delay: str | None = None) None

Sets the sense parameters for Frequency measurement. (For GDM-906X)

Parameters:
  • rel_stat (str, optional) – Relative function state. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • rel_val (str, optional) – Relative value. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (-1.2e6 to 1.2e6 Hz).

  • rel_val_auto (str, optional) – Relative value auto on/off. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • timeout_auto (str, optional) – Assigns timeout time at the frequency measurement. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • trig_delay (str, optional) – Trigger delay time. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0 ~ 3600 s).

set_hold_measurement(percentage: float | None = None) None

Sets the percentage threshold for the Hold function.

Parameters:

percentage (float) – Percentage threshold, one of 0.01, 0.1, 1, or 10.

set_math_b_offset(offset: str | None = None) None

Sets the offset factor B for math measurements.

Parameters:

offset (str) – Offset factor B, one of ‘MIN’, ‘MAX’, or a numeric value.

set_math_m_factor(factor: str | None = None) None

Sets the scale factor M for math measurements.

Parameters:

factor (str) – Scale factor M, one of ‘MIN’, ‘MAX’, or a numeric value.

set_math_percent(value: str | None = None) None

Sets the reference value for the Percent function.

Parameters:

value (str) – Reference value, one of ‘MIN’, ‘MAX’, or a numeric value.

set_period_sense(rel_stat: str | None = None, rel_val: str | None = None, rel_val_auto: str | None = None, timeout_auto: str | None = None, trig_delay: str | None = None) None

Sets the sense parameters for Period measurement. (For GDM-906X)

Parameters:
  • rel_stat (str, optional) – Relative function state. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • rel_val (str, optional) – Relative value. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (-1.2 to 1.2 s).

  • rel_val_auto (str, optional) – Relative value auto on/off. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • timeout_auto (str, optional) – Assigns timeout time at the period measurement. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • trig_delay (str, optional) – Trigger delay time. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0 ~ 3600 s).

set_refresh_rate(rate: str | None = None) None

Sets the detection rate (sample rate).

Parameters:

rate (str) – One of ‘S’ for SLOW, ‘M’ for MID, or ‘F’ for FAST.

set_relative_reference(reference: str | None = None) None

Sets the reference value for the relative function. (For GDM-8261A)

Parameters:

reference (str) – Reference value, one of ‘MIN’, ‘MAX’, or a numeric value.

set_resistance_sense(rel_stat: str | None = None, rel_val: str | None = None, rel_val_auto: str | None = None, trig_delay: str | None = None, auto_zero: str | None = None) None

Sets the sense parameters for 2-wire resistance measurement. (For GDM-906X)

Parameters:
  • rel_stat (str, optional) – Relative function state. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • rel_val (str, optional) – Relative value. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (-120.0 ~ 120.0 MΩ).

  • rel_val_auto (str, optional) – Relative value auto on/off. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • trig_delay (str, optional) – Trigger delay time. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0 ~ 3600 s). Minimum step is microseconds.

  • auto_zero (str, optional) – Auto zero mode. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’.

set_scpi_delay(delay: float) None

Set the SCPI delay

Parameters:

delay (float) – delay time

set_statistic_calculation_state(state: str | None = None) None

Turns the statistic calculation function on or off. (For GDM-906X)

Parameters:

state (int or str) – The state to set, must be one of 0, 1, ‘ON’, ‘OFF’.

set_store_count(count: str | None = None) None

Sets the number of measurement counts that are recorded with the Store measurement function. (For GDM-8261A)

Parameters:

count (str) – Number of counts to record, an integer value between 2 and 9999, or ‘MIN’ or ‘MAX’.

set_temperature_sense(rel_stat: str | None = None, rel_val: str | None = None, rel_val_auto: str | None = None, res: str | None = None, probe_type: str | None = None, trig_delay: str | None = None, auto_zero: str | None = None) None

Sets the sense parameters for Temperature measurement. (For GDM-906X)

Parameters:
  • rel_stat (str, optional) – Relative function state. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • rel_val (str, optional) – Relative value. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (-1.0e15 to 1.0e15).

  • rel_val_auto (str, optional) – Relative value auto on/off. Acceptable values include 0, 1, ‘ON’, or ‘OFF’.

  • res (str, optional) – Temperature measurement resolution. Acceptable values include ‘DEF’, ‘MIN’, ‘MAX’, or a specific numeric value.

  • probe_type (str, optional) – Temperature probe type. Acceptable values include ‘TC’, ‘RTD’, ‘FRTD’, ‘THER’, ‘FTH’.

  • trig_delay (str, optional) – Trigger delay time. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0 ~ 3600 s).

  • auto_zero (str, optional) – Auto zero mode. Acceptable values include 0, 1, ‘ON’, ‘OFF’, or ‘ONCE’.

set_temperature_unit(unit: str | None = None) None

Sets the temperature unit.

Parameters:

unit (str) – Temperature unit, one of ‘C’ or ‘F’.

set_therm2w_sense(a_param: str | None = None, b_param: str | None = None, c_param: str | None = None, sensor: str | None = None) None

Sets the sense parameters for 2-wire Thermistor measurement. (For GDM-906X)

Parameters:
  • a_param (str, optional) – Thermistor A coefficient. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0.0~9.999999).

  • b_param (str, optional) – Thermistor B coefficient. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0.0~9.999999).

  • c_param (str, optional) – Thermistor C coefficient. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0.0~9.999999).

  • sensor (str, optional) – Thermistor sensor type. Acceptable values include 2200 (2.2kΩ), 5000 (5kΩ), 10000 (10kΩ), or ‘USER’.

set_therm4w_sense(a_param: str | None = None, b_param: str | None = None, c_param: str | None = None, sensor: str | None = None) None

Sets the sense parameters for 4-wire Thermistor measurement. (For GDM-906X)

Parameters:
  • a_param (str, optional) – Thermistor A coefficient. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0.0~9.999999).

  • b_param (str, optional) – Thermistor B coefficient. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0.0~9.999999).

  • c_param (str, optional) – Thermistor C coefficient. Acceptable values include ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0.0~9.999999).

  • sensor (str, optional) – Thermistor sensor type. Acceptable values include 2200 (2.2kΩ), 5000 (5kΩ), 10000 (10kΩ), or ‘USER’.

set_trigger_parameters(source: str | None = None, delay: str | None = None, auto: str | None = None, sample_count: str | None = None, trigger_count: str | None = None, delay_time_auto: str | None = None, signal_slope: str | None = None, eom_slope: str | None = None) None

Sets the trigger parameters including source, delay, auto mode, sample count, trigger count, and auto delay mode.

Parameters:
  • source (str) – Trigger source, one of ‘INT’ or ‘EXT’. For GDM-906X: one of ‘IMM’, ‘EXT’, ‘BUS’.

  • delay (str) – Trigger delay time. For GDM-8261A: one of ‘MIN’, ‘MAX’, or a numeric value (0 ~ 9999 ms). For GDM-906X: one of ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (0 ~ 3600 s), with a minimum step of microseconds.

  • auto (str) – Trigger auto mode, one of ‘ON’ or ‘OFF’.

  • sample_count (str) – Number of samples. For GDM-8261A: one of ‘MIN’, ‘MAX’, or a numeric value (1 ~ 9999). For GDM-906X: one of ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (1.0 ~ 1000000.0).

  • trigger_count (str) – Number of trigger counts. For GDM-8261A: one of ‘MIN’, ‘MAX’, or a numeric value (1 ~ 9999). For GDM-906X: one of ‘MIN’, ‘MAX’, ‘DEF’, or a numeric value (1.0 ~ 1000000.0).

  • delay_time_auto (int or str) – Trigger delay time auto mode, one of 0, 1, ‘ON’, or ‘OFF’. (For GDM-906X)

  • signal_slope (str) – Trigger signal slope, one of ‘POS’ or ‘NEG’. (For GDM-906X)

  • eom_slope (str, optional) – EOM output signal slope, one of ‘POS’ or ‘NEG’.(For GDM-906X)

write(cmd: str) None

Write an SCPI command to the instrument.

Parameters:

cmd (str) – SCPI command to be written.