Data Acquisition Toolbox

Configuring Property Values

You configure property values with the set function or the dot notation. In practice, you can configure many of the properties at any time while the device object exists. However, some properties are not configurable while the object is running. Use the propinfo function, or refer to Base Property Reference, for information about when a property is configurable.

The syntax used to configure common and channel/line properties is described below. The examples are based on the analog input object ai created in Returning Property Names and Property Values.

Common Properties

You can configure a single property value using the set function

• set(ai,'TriggerType','Manual')
  

or the dot notation

• ai.TriggerType = 'Manual';
  

To configure values for multiple properties, you can supply multiple property name/property value pairs to set.

• set(ai,'SampleRate',44100,'Name','Test1-winsound')
  

Note that you can configure only one property value at a time using the dot notation.

Channel and Line Properties

To configure channel (line) properties for one or more channels (lines) contained by a device object, you must use the Channel (Line) property. For example, to configure the SensorRange property for the first channel contained by ai, you can use the set function

• set(ai.Channel(1),'SensorRange',[-2 2])
  

or the dot notation

• ai.Channel(1).SensorRange = [-2 2];
  

To configure values for multiple channel or line properties, you supply multiple property name/property value pairs to set.

• set(ai.Channel(1),'SensorRange',[-2 2],'ChannelName','Chan1')
  

To configure multiple property values for multiple channels:

• chs = ai.Channel(1:2);
  set(chs,{'SensorRange','ChannelName'},{[-2 2],'Chan1';[0 4], 
  'Chan2'});
  

Returning Property Names and Property Values

Specifying Property Names