daqread
Data Acquisition Toolbox(.daq
) 파일 읽기
구문
data = daqread('filename')
[data,time] = daqread(...)
[data,time,abstime] = daqread(...)
[data,time,abstime,events] = daqread(...)
[data,time,abstime,events,daqinfo] = daqread(...)
data = daqread(...,'Param1'
, Val1,...)
daqinfo = daqread('filename','info')
설명
data = daqread('filename')
은 filename
으로 지정된 Data Acquisition Toolbox™(.daq
) 파일의 모든 데이터를 읽어 들입니다. daqread
는 m×n 데이터 행렬인 data
를 반환합니다. 여기서 m은 샘플의 개수이고 n은 채널의 개수입니다. data
가 여러 트리거의 데이터를 포함하는 경우 각 트리거의 데이터는 NaN
을 구분자로 사용해 구분됩니다. OutputFormat
속성을 tscollection
으로 설정하면 daqread
는 시계열 컬렉션 객체를 반환합니다. 자세한 내용은 아래를 참조하십시오.
[data,time] = daqread(...)
는 시간/값 쌍을 반환합니다. time
은 각 샘플에 대한 상대 시간을 포함하는 m×1 벡터로, data
와 길이가 동일합니다. 상대 시간은 발생한 첫 번째 트리거에 대한 측정입니다.
[data,time,abstime] = daqread(...)
는 첫 번째 트리거의 절대 시간을 반환합니다. abstime
은 clock
벡터로 반환됩니다.
[data,time,abstime,events] = daqread(...)
는 이벤트의 로그를 반환합니다. events
는 이벤트 정보를 포함하는 구조체입니다. Samples
, Time
또는 Triggers
파라미터(아래 참조)를 지정하면 events 구조체에는 지정된 이벤트만 포함됩니다.
[data,time,abstime,events,daqinfo] = daqread(...)
는 ObjInfo
와 HwInfo
, 두 필드를 포함하는 구조체 daqinfo
를 반환합니다. ObjInfo
는 속성 이름/속성값 쌍을 포함하는 구조체이며 HwInfo
는 하드웨어 정보를 포함하는 구조체입니다. 전체 이벤트 로그는 daqinfo.ObjInfo.EventLog
로 반환됩니다.
data = daqread(...,
은 다음 파라미터를 사용하여 반환되는 데이터의 양과 형식을 지정합니다.'Param1'
, Val1,...)
파라미터 | 설명 |
---|---|
| 샘플 범위를 지정합니다. |
| 상대 시간 범위를 지정합니다. |
| 트리거 범위를 지정합니다. |
| 채널 범위를 지정합니다. 채널 이름은 셀형 배열로 지정할 수 있습니다. |
| 데이터 형식을 |
| 시간 형식을 |
| 출력 형식을 |
Samples
, Time
및 Triggers
속성은 상호 배타적입니다. 즉, 하나의 함수 호출에서 이들 중 하나만 지정할 수 있습니다.
daqinfo = daqread('filename','info')
는 파일 데이터 읽기 오버헤드를 발생시키지 않고 daqinfo
구조체에서 파일의 메타데이터를 반환합니다. daqinfo
구조체는 다음 두 필드를 포함합니다.
daqinfo.ObjInfo
파일
filename
을 만드는 데 사용되는 데이터 수집 객체에 대한 파라미터/값 쌍을 포함하는 구조체입니다. 참고:UserData
속성값은 복원되지 않습니다.daqinfo.HwInfo
하드웨어 정보를 포함하는 구조체입니다. 전체 이벤트 로그는
daqinfo.ObjInfo.EventLog
로 반환됩니다.
예제
이 예제에서는 이전 릴리스에서 로그 파일 data.daq
에 저장되었던 데이터를 읽어 들이는 방법을 보여줍니다. 이 로깅은 analoginput
객체의 로깅 속성을 지정하여 얻은 것입니다. daqread
를 사용하여 데이터 및 기타 수집 관련 정보를 가져옵니다.
data.daq
에서 모든 샘플-시간 쌍을 읽어 들입니다.
[data,time] = daqread('data.daq');
data.daq
에서 모든 채널에 대해 샘플 500-1,000을 읽어 들입니다.
data = daqread('data.daq','Samples',[500 1000]);
파일 data.daq
에서 채널 인덱스 2, 4, 7의 샘플 1,000-2,000을 네이티브 형식으로 읽어 들입니다.
data = daqread('data.daq', 'Samples', [1000 2000],... 'Channels', [2 4 7], 'DataFormat', 'native');
파일 data.daq
에서 모든 채널의 첫 번째 트리거와 두 번째 트리거를 나타내는 데이터만 읽어 들입니다.
[data,time] = daqread('data.daq', 'Triggers', [1 2]);
data.daq
에서 채널 속성 정보를 가져옵니다.
daqinfo = daqread('data.daq','info'); chaninfo = daqinfo.ObjInfo.Channel;
data.daq
가 포함하는 이벤트 유형과 이벤트 데이터 목록을 가져옵니다.
daqinfo = daqread('data.daq','info'); events = daqinfo.ObjInfo.EventLog; event_type = {events.Type}; event_data = {events.Data};
파일 data.daq
의 모든 데이터를 읽고 시계열 컬렉션 객체로 반환합니다.
data = daqread('data.daq','OutputFormat','tscollection');
팁
.daq 파일에 대한 세부 정보
여러 트리거에서 데이터를 읽어 들인 경우 그 결과로 생성된 데이터 배열의 크기는 각 트리거가
NaN
으로 구분되므로 발생한 트리거의 개수만큼 증가합니다.ObjInfo.EventLog
는Samples
,Time
또는Triggers
로 지정된 값에 상관없이 항상 전체 이벤트 로그를 포함합니다.장치 객체(
ObjInfo
) 정보를 반환할 때UserData
속성값은 복원되지 않습니다..daq
파일을 읽을 때daqread
함수는 셀형 배열로 지정된 속성값을 반환하지 않습니다.
반환된 시계열 컬렉션 객체에 대한 세부 정보
OutputFormat
을 tscollection
으로 설정한 경우 daqread
는 시계열 컬렉션 객체를 반환합니다. 이 시계열 컬렉션 객체는 파일의 각 채널에 대한 절대 시계열 객체를 포함합니다. 다음은 daqread
가 시계열 컬렉션 객체와 시계열 객체의 일부 속성을 설정하는 방법에 대해 설명합니다.
시계열 컬렉션 객체의
time
속성은 파일에 지정된InitialTriggerTime
속성의 값으로 설정됩니다.각 시계열 객체의
name
속성은 파일 내 채널의Name
속성값으로 설정됩니다. 이 이름을 시계열 객체 이름으로 사용할 수 없는 경우daqread
는 채널의 이름을'Channel'
로 설정하고HwChannel
속성을 추가(Append)합니다.시계열 객체의
Units
속성값은DataFormat
파라미터의 값에 따라 달라집니다.DataFormat
파라미터를'double'
로 설정하면daqread
는 해당 컬렉션에 있는 각 시계열 객체의DataInfo
속성을 파일 내 대응하는 채널의Units
속성값으로 설정합니다.DataFormat
파라미터를'native'
로 설정하면daqread
는Units
속성을'native'
로 설정합니다.각 시계열 객체에는 채널에 대한 이벤트 로그가 첨부되어
tsdata.event
객체로 보유됩니다.