Examples
You can download all nidmm examples for latest version here
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
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
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