User manual

Series 3700 System Switch/Multimeter Reference Manual Section 10: TSP-Net
3700S-901-01 Rev. C / July 2008 10-13
tspnet.tsp.rbtablecopy()
Function
Copies a reading buffer synchronous table from a device.
Usage
<array> = tspnet.tsp.rbtablecopy(<connection id>, <name>,
[<start index>, <end index>])
connection id: Integer value used as a handle for other tspnet commands
name: Parameter name from a listed group
start index: Integer start value
end index: Integer end value
Remarks
This convenience command reads the data from a reading buffer on a remote device
and returns an array of numbers or a string representing the data. The name argument
identifies the reading buffer name and synchronous table to copy. The optional start
index and end index specify the portion of the reading buffer to read. If no index is
specified, the entire buffer will be copied.
This command is limited to transferring 50,000 readings at a time.
Errors:
Invalid Specified Connection
Write Failed, Timeout
Write Failed
Read Failed, Timeout
Read Failed, Aborted
Read Failed
Invalid Reading Buffer Table
Invalid Index Range
Out of Memory
Remote Error, <remote error generated by command>
Example
table = tspnet.tsp.rbtablecopy(mytspdevice,
'myremotebuffername.readings', 1, 3)
print(table[1], table[2], table[3])
Output:
4.5653423423e-1 4.5267523423e-1 4.5753543423e-1
times = tspnet.tsp.rbtablecopy(mytspdevice,
'myremotebuffername.timestamps', 1, 3)
print(times)
Output
01/01/2008 10:10:10.0000013,01/01/2008
10:10:10.0000233,01/01/2008 10:10:10.0000576