User manual

Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL)
3700S-901-01 Rev. C / July 2008 13-167
dmm.savebuffer()
Usage
dmm.savebuffer('<reading buffer name>', '<filename>',
time_format)
reading buffer name: The name of a previously created DMM reading buffer,
specified as a string. Do not pass the reading buffer name without quotes because this
generates a data type error. For example, if the reading buffer is mybuffer, then the
buffer name should be specified as "mybuffer" and not mybuffer.
filename: The destination filename located on the USB flash drive. The filename must
specify the full path (including /usb1/) and include the name of file with the file
extension .csv. If no file extension is specified, .csv will be added to filename.
time_format: This optional parameter indicates what date and time information should
be saved in the file to the thumb drive. Use the following values for time_format:
dmm.buffer.SAVE_RELATIVE_TIME, which saves relative time stamps only
dmm.buffer.SAVE_FORMAT_TIME, which is the default if no time format
specified and saves dates, times and fractional seconds
dmm.buffer.SAVE_RAW_TIME, which saves seconds and fractional seconds
only
dmm.buffer.SAVE_TIMESTAMP_TIME, which only saves time stamps
For options that save more than one item of time information, each item is comma
delimited. For example, dmm.buffer.SAVE_FORMAT_TIME will have <date>,
<time>, and <fractional seconds> for each reading.
Remarks
The first parameter (reading buffer name) represents the reading buffer to be saved.
The second (filename) is the filename of file to save reading buffer data to on USB
flash drive. The third parameter is optional and indicates how the date and time
information from the buffer should be saved. For options that save more than one item
of time information, each item is comma delimited. For example, the default format will
have <date>, <time>, and <fractional seconds) for each reading.
Errors will be generated if reading buffer does not exist or is not a DMM buffer, or if the
destination filename is not specified correctly. The .csv is appended to the filename
(unless the .csv is specified by user). Any specified file extension other than .csv
will generate errors.
Valid destination filename examples:
dmm.savebuffer('mybuffer', '/usb1/mydata')
dmm.savebuffer('mybuffer', '/usb1/mydata.csv')
Invalid destination filename examples:
dmm.savebuffer('mybuffer', '/usb1/mydata.')
-Invalid extension due to period by no following letters for extension.
dmm.savebuffer('mybuffer', '/usb1/mydata.txt')
-Invalid extension. Use .csv or do not specify (no period)
dmm.savebuffer('mybuffer', '/usb1/mydata.txt.csv')
-invalid extension because 2 periods specified (mydata_txt.csv would be
correct).