CLASS ndi.daq.daqsystemstring

  NDI_DAQSYSTEMSTRING - a class for describing the device and channels that correspond to an NDI_EPOCHPROBEMAP_DAQSYSTEM

   ndi.daq.daqsystemstring

   A 'devicestring' is a part of an ndi.epoch.epochprobemap_daqsystem that indicates the channel types and
   channel numbers that correspond to a particular record.

   For example, one may specify that a 4-channel extracellular recording with name
   'ctx' and reference 1 was recorded on a device called 'mydevice' via analog input
   on channels 27-28 and 45 and 88 with the following ndi.epoch.epochprobemap_daqsystem entry:
            name: 'ctx'
       reference: 1
            type: 'extracellular_electrode-4'
    devicestring: 'mydevice:ai27-28,45,88

   The form of a device string is DEVICENAME:CT####, where DEVICENAME is the name of 
   ndi.daq.system object, CT is the channel type identifier, and #### is a list of channels.
   The #### list of channels should be numbered from 1, and can use the symbols '-' to
   indicate a sequential run of channels, and ',' to separate channels.
   Use a semicolon to separate channel types (e.g., 'ai27-28;di1')

   For example:
      '1-5,10,17'      corresponds to [1 2 3 4 5 10 17]
      '2,5,11-12,8     corresponds to [2 5 11 12 8]
      ''               corresponds to []  % if the device doesn't have channels


   See also: ndi.daq.daqsystemstring/NDI_DEVICESTRING, NDI_DEVICESTRING/DEVICESTRING

Superclasses

none

Properties

Property	Description
devicename	The name of the device
channeltype	The type of channels that are used by the device
channellist	An array of the channels that are referred to by the devicestring

Methods

Method	Description
daqsystemstring	Create an NDI_DEVICESTRING object from a string or from a device name, channel type, and channel list
devicestring	Produce an ndi.daq.daqsystemstring character string
ndi_daqsystemstring2channel	Convert an ndi.daq.daqsystemstring to device, channel type, channel list

Methods help

daqsystemstring - Create an NDI_DEVICESTRING object from a string or from a device name, channel type, and channel list

DEVSTR = ndi.daq.daqsystemstring(DEVICENAME, CHANNELTYPE, CHANNELLIST)
     or DEVSTR = ndi.daq.daqsystemstring(DEVSTRING)

  Creates a device string suitable for a ndi.epoch.epochprobemap_daqsystem from a DEVICENAME,
  a cell array of strings CHANNELTYPE (such as 'ai', 'di', 'ao'), and a CHANNELLIST.

  Inputs:
     In the first form:
       DEVICENAME should be the name of an ndi.daq.system
       CHANNEL_PREFIX should be the prefix for a particular type of channel. These channel type will vary from
           device to device. For example, a NDI_DAQSYSTEM_MULTICHANNELDAQ might use:
             'ai' - analog input
             'ao' - analog output (it is an 'o' like 'oh', not 0)
             'di' - digital input
             'do' - digital output
       CHANNELLIST should be an array of channel numbers, which must start from 1 (that is,
             the first channel is 1).
     In the second form:
       DEVSTRING should be in the form: 'devicename:ct#,#-#,#,#'
         where devicename is the name of the device, ct is a string that corresponds to the channel type, and
         the numbers and separators specify the channel numbers to be accessed.

  Examples:

       myndi_daqsystemstring1 = ndi_devicestring('mydevice','ai',[1:5 7 23])
       myndi_daqsystemstring2 = ndi_devicestring('mydevice:ai1-5,7,23');

  See also: ndi.daq.daqsystemstring

    Documentation for ndi.daq.daqsystemstring/daqsystemstring
       doc ndi.daq.daqsystemstring

---

devicestring - Produce an ndi.daq.daqsystemstring character string

DEVSTR = DEVICESTRING(SELF)

  Creates a device string suitable for a ndi.epoch.epochprobemap_daqsystem from an ndi.daq.daqsystemstring object.

  Inputs:
     SELF - an ndi.daq.daqsystemstring object
  Outputs:
     DEVSTR - the device string; e.g., 'mydevice:ai1-5,10,11-23'


  See also: ndi.daq.daqsystemstring

---

ndi_daqsystemstring2channel - Convert an ndi.daq.daqsystemstring to device, channel type, channel list

[DEVICENAME, CHANNELTYPE, CHANNELLIST] = NDI_DAQSYSTEMSTRING2CHANNEL(SELF, DEVSTR)

  Returns the device name (DEVICENAME), channel type (CHANNELTYPE), and channel list
  (CHANNEL) of a device string.

  Inputs:
     DEVSTR should be an NDI devicestring in the form: devicename:ct#,#-#,#,#
  Outputs:
     DEVICENAME is the string corresponding to the device name
     CHANNELTYPE is a cell array of strings with channel types
     CHANNELLIST is an array of the channel numbers

  Example:
     devstr = ndi.daq.daqsystemstring('mydevice:ai1-5,13,18');
     [devicename, channeltype, channel] = ndi_daqsystemstring2channel(devstr);
     % devicename == 'mydevice', channelype = 'ai', channel == [1 2 3 4 5 13 18]

  See also: ndi.daq.daqsystemstring, NDI_DEVICESTRING/DEVICESTRING

---