daq.createSession

(Not recommended) Create data acquisition session for specific vendor hardware

This session object function is not recommended. Use DataAcquisition object functions instead. See Compatibility Considerations.

Syntax

session = daq.createSession(vendor)

Description

session = daq.createSession(vendor) creates a session object for configuring and operating data acquisition devices from the specified vendor.

Examples

Create Data Acquisition Session for National Instruments Devices

Create a data acquisition session object s, for National Instruments^® devices.

s = daq.createSession('ni')

s = 

Data acquisition session using National Instruments hardware:
   Will run for 1 second (1000 scans) at 1000 scans/second.
   No channels have been added.   

Input Arguments

vendor — Vendor name

character vector or string

Vendor name for the device you want to create a session for, specified as a character vector. Valid vendors are:

• 'ni'

• 'digilent'

• 'directsound'

• 'adi'

• 'mcc'

Data Types: char | string

Output Arguments

session — Data acquisition session

session object

Data acquisition session, returned as a session object. 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.

The session has the following properties:

Channels	Array of channel objects associated with session object
Connections	Array of connections in session
DurationInSeconds	Specify duration of acquisition
IsContinuous	Specify if operation continues until manually stopped
IsDone	Indicate if session operation is complete
IsLogging	Indicate if hardware is acquiring or generating data
IsNotifyWhenDataAvailableExceedsAuto	Control if NotifyWhenDataAvailableExceeds is set automatically
IsNotifyWhenScansQueuedBelowAuto	Control if NotifyWhenScansQueuedBelow is set automatically
NotifyWhenDataAvailableExceeds	Control firing of DataAvailable event
NotifyWhenScansQueuedBelow	Control firing of DataRequired event
NumberOfScans	Number of scans for operation when starting
Range	Specify channel measurement range
Rate	Rate of operation in scans per second
RateLimit	Limit of rate of operation based on hardware configuration
ScansAcquired	Number of scans acquired during operation
ScansOutputByHardware	Indicate number of scans output by hardware
ScansQueued	Indicate number of scans queued for output
UserData	Custom data
Vendor	Vendor information associated with session object

Compatibility Considerations

session object interface is not recommended

Not recommended starting in R2020a

Use of this function with a session object is not recommended. To access a data acquisition device, use a DataAcquisition object with its functions and properties instead.

For more information about using the recommended functionality, see Transition Your Code from Session to DataAcquisition Interface.