startForeground

Start foreground operations

Syntax

startForeground(s);

data = startForeground(s);

[data,timeStamps,triggerTime] = startForeground(s);

Description

startForeground(s); starts operations of the session object, s, and blocks MATLAB^® command line and other code until the session operation is complete.

data = startForeground(s); returns the data acquired in the output parameter, data.

[data,timeStamps,triggerTime] = startForeground(s); returns the data acquired, timestamps relative to the time the operation is triggered, and a trigger time indicating the absolute time the operation was triggered.

Examples

Acquire Analog Data

Acquire data by creating a session with an analog input channel.

s = daq.createSession('ni');
addAnalogInputChannel(s,'cDAQ1Mod1','ai0','Voltage');

Start the acquisition and save the acquired data into the variable data:

	data = startForeground(s);

Generate Analog Data

Generate a signal by creating a session with an analog output channel.

s = daq.createSession('ni');
addAnalogOutputChannel(s,'cDAQ1Mod2','ao0','Voltage');

Create and queue an output signal and start the generation:

outputSignal = linspace(-1,1,1000)';
queueOutputData(s,outputSignal);
startForeground(s);

Acquire Analog Input Data and Timestamps

s = daq.createSession('ni');
addAnalogInputChannel(s,'cDAQ1Mod1','ai0','Voltage');

Start the acquisition and save the acquired data in the variable data, the acquisition timestamp in timestamps, and the trigger time in triggerTime:

	[data,timestamps,triggerTime] = startForeground(s);

Input Arguments

s — Data acquisition session

session object

Data acquisition session, specified as a session object. Create the session object using daq.createSession. Use the data acquisition session for acquisition and generation operations. Create one session per vendor and use that vendor session to perform all data acquisition operations.

Output Arguments

data — Values of acquired data

array of doubles

Values of acquired data, returned as an m-by-n array of doubles, where m is the number of scans acquired, and n is the number of input channels in the session.

timeStamps — Recorded timestamp

numeric

Recorded timestamp relative to the time the operation is triggered, returned as an m-by-1 array, where m is the number of scans.

triggerTime — Timestamp of acquired data

numeric

Timestamp of acquired data which is a MATLAB serial date timestamp representing the absolute time when timeStamps = 0.