Data Acquisition Toolbox

getsample

Immediately acquire one sample

Syntax

• sample = getsample(obj)
  

Arguments

obj	An analog input object.
sample	A row vector containing one sample for each channel contained by obj.

Description

sample = getsample(obj) immediately returns a row vector containing one sample for each channel contained by obj.

Remarks

Using getsample is a good way to test your analog input configuration. Additionally:

• getsample does not store samples in, or extract samples from, the data acquisition engine.
• You can execute getsample at any time after channels have been added to obj.
• Except for sound cards, you can use getsample on an analog input object that is not running (Running is Off). For sound cards, the device object must be running.

Example

Create the analog input object ai and add eight channels to it.

• ai = analoginput('nidaq',1);
  ch = addchannel(ai,0:7);
  

The following command returns one sample for each channel.

• sample = getsample(ai);
  

See Also

Functions

getdata, peekdata

getdata

getvalue