Examples

You can download all nidmm examples here

nidmm_fetch_waveform.py

(nidmm_fetch_waveform.py)
 1#!/usr/bin/python
 2
 3import argparse
 4import nidmm
 5import sys
 6import time
 7
 8
 9def example(resource_name, options, function, range, points, rate):
10    with nidmm.Session(resource_name=resource_name, options=options) as session:
11        session.configure_waveform_acquisition(measurement_function=nidmm.Function[function], range=range, rate=rate, waveform_points=points)
12        with session.initiate():
13            while True:
14                time.sleep(0.1)
15                backlog, acquisition_state = session.read_status()
16                if acquisition_state == nidmm.AcquisitionStatus.FINISHED_WITH_NO_BACKLOG:
17                    break
18                measurements = session.fetch_waveform(array_size=backlog)
19                print(measurements)
20
21
22def _main(argsv):
23    parser = argparse.ArgumentParser(description='Performs a waveform acquisition using the NI-DMM API.', formatter_class=argparse.ArgumentDefaultsHelpFormatter)
24    parser.add_argument('-n', '--resource-name', default='PXI1Slot2', help='Resource name of an NI digital multimeter.')
25    parser.add_argument('-f', '--function', default='WAVEFORM_VOLTAGE', choices=nidmm.Function.__members__.keys(), type=str.upper, help='Measurement function.')
26    parser.add_argument('-r', '--range', default=10, type=float, help='Measurement range.')
27    parser.add_argument('-p', '--points', default=10, type=int, help='Specifies the number of points to acquire before the waveform acquisition completes.')
28    parser.add_argument('-s', '--rate', default=1000, type=int, help='Specifies the rate of the acquisition in samples per second.')
29    parser.add_argument('-op', '--option-string', default='', type=str, help='Option string')
30    args = parser.parse_args(argsv)
31    example(args.resource_name, args.option_string, args.function, args.range, args.points, args.rate)
32
33
34def main():
35    _main(sys.argv[1:])
36
37
38def test_example():
39    options = {'simulate': True, 'driver_setup': {'Model': '4082', 'BoardType': 'PXIe', }, }
40    example('PXI1Slot2', options, 'WAVEFORM_VOLTAGE', 10, 10, 1000)
41
42
43def test_main():
44    cmd_line = ['--option-string', 'Simulate=1, DriverSetup=Model:4082; BoardType:PXIe', ]
45    _main(cmd_line)
46
47
48if __name__ == '__main__':
49    main()
50
51

nidmm_measurement.py

(nidmm_measurement.py)
 1#!/usr/bin/python
 2
 3import argparse
 4import nidmm
 5import sys
 6
 7
 8def example(resource_name, option_string, function, range, digits):
 9    with nidmm.Session(resource_name=resource_name, options=option_string) as session:
10        session.configure_measurement_digits(measurement_function=nidmm.Function[function], range=range, resolution_digits=digits)
11        print(session.read())
12
13
14def _main(argsv):
15    supported_functions = list(nidmm.Function.__members__.keys())
16    parser = argparse.ArgumentParser(description='Performs a single measurement using the NI-DMM API.', formatter_class=argparse.ArgumentDefaultsHelpFormatter)
17    parser.add_argument('-n', '--resource-name', default='PXI1Slot2', help='Resource name of an NI digital multimeter.')
18    parser.add_argument('-f', '--function', default=supported_functions[0], choices=supported_functions, type=str.upper, help='Measurement function.')
19    parser.add_argument('-r', '--range', default=10, type=float, help='Measurement range.')
20    parser.add_argument('-d', '--digits', default=6.5, type=float, help='Digits of resolution for the measurement.')
21    parser.add_argument('-op', '--option-string', default='', type=str, help='Option string')
22    args = parser.parse_args(argsv)
23    example(args.resource_name, args.option_string, args.function, args.range, args.digits)
24
25
26def main():
27    _main(sys.argv[1:])
28
29
30def test_example():
31    options = {'simulate': True, 'driver_setup': {'Model': '4082', 'BoardType': 'PXIe', }, }
32    example('PXI1Slot2', options, 'DC_VOLTS', 10, 6.5)
33
34
35def test_main():
36    cmd_line = ['--option-string', 'Simulate=1, DriverSetup=Model:4082; BoardType:PXIe', ]
37    _main(cmd_line)
38
39
40if __name__ == '__main__':
41    main()
42
43

nidmm_multi_point_measurement.py

(nidmm_multi_point_measurement.py)
 1#!/usr/bin/python
 2
 3import argparse
 4import nidmm
 5import sys
 6
 7
 8def example(resource_name, options, function, range, digits, samples, triggers):
 9    with nidmm.Session(resource_name=resource_name, options=options) as session:
10        session.configure_measurement_digits(measurement_function=nidmm.Function[function], range=range, resolution_digits=digits)
11        session.configure_multi_point(trigger_count=triggers, sample_count=samples)
12        measurements = session.read_multi_point(array_size=samples)
13        print('Measurements: ', measurements)
14
15
16def _main(argsv):
17    parser = argparse.ArgumentParser(description='Performs a multipoint measurement using the NI-DMM API.', formatter_class=argparse.ArgumentDefaultsHelpFormatter)
18    parser.add_argument('-n', '--resource-name', default='PXI1Slot2', help='Resource name of an NI digital multimeter.')
19    parser.add_argument('-f', '--function', default='DC_VOLTS', choices=nidmm.Function.__members__.keys(), type=str.upper, help='Measurement function.')
20    parser.add_argument('-r', '--range', default=10, type=float, help='Measurement range.')
21    parser.add_argument('-d', '--digits', default=6.5, type=float, help='Digits of resolution for the measurement.')
22    parser.add_argument('-s', '--samples', default=10, type=int, help='The number of measurements the DMM makes.')
23    parser.add_argument('-t', '--triggers', default=1, type=int, help='Sets the number of triggers you want the DMM to receive before returning to the Idle state.')
24    parser.add_argument('-op', '--option-string', default='', type=str, help='Option string')
25    args = parser.parse_args(argsv)
26    example(args.resource_name, args.option_string, args.function, args.range, args.digits, args.samples, args.triggers)
27
28
29def main():
30    _main(sys.argv[1:])
31
32
33def test_example():
34    options = {'simulate': True, 'driver_setup': {'Model': '4082', 'BoardType': 'PXIe', }, }
35    example('PXI1Slot2', options, 'DC_VOLTS', 10, 6.5, 10, 1)
36
37
38def test_main():
39    cmd_line = ['--option-string', 'Simulate=1, DriverSetup=Model:4082; BoardType:PXIe', ]
40    _main(cmd_line)
41
42
43if __name__ == '__main__':
44    main()
45
46
47