이 페이지는 기계 번역을 사용하여 번역되었습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

tdmsread

TDMS 파일에서 데이터 읽기

R2022a 이후

구문

data = tdmsread(tdmsfile)

data = tdmsread(tdmsfile,Name=Value)

설명

data = tdmsread(tdmsfile)는 지정된 TDMS 파일에서 데이터를 검색하여 테이블로 구성된 셀형 배열을 반환합니다. 셀 배열의 각 요소는 채널 그룹에 해당하는 테이블입니다.

data = tdmsread(tdmsfile,Name=Value)는 이름-값 쌍을 사용하여 데이터 판독을 필터링하고 출력 형식을 지정합니다.

예제

TDMS 파일 데이터 읽기

지정된 TDMS 파일에서 데이터를 읽습니다. 어떤 채널을 읽을지, 결과의 형식을 결정할 수 있습니다.

TDMS 파일의 모든 데이터를 테이블로 읽습니다.

data = tdmsread("airlinesmall.tdms");

TDMS 파일에 있는 변수의 하위 집합을 타임테이블로 MATLAB^®로 읽어옵니다. TDMS 파일에서 ArrTime 변수를 출력 타임테이블의 시간 벡터로 사용합니다.

data = tdmsread("airlinesmall.tdms", ...
           ChannelGroupName = "Airline", ...
           ChannelNames = ["ArrTime" "FlightNum" "ArrDelay"], ...
           RowTimes = "ArrTime");

지정된 시작 시간과 단계 기간을 사용하여 채널 데이터를 타임테이블로 읽습니다.

data = tdmsread("airlinesmall.tdms", ...
           ChannelGroupName = "Airline", ...
           ChannelNames = ["ArrTime" "FlightNum" "ArrDelay"], ...
           TimeStep = seconds(0.01), StartTime = seconds(30));

입력 인수

tdmsfile — TDMS 파일 이름

string

문자열로 지정된 TDMS 파일 이름입니다.

로컬 파일의 경우 파일 이름과 확장자가 포함된 전체 경로나 상대 경로를 사용하십시오. MATLAB 경로에 파일을 지정할 수도 있습니다.

인터넷 파일의 경우 URL을 지정하십시오. 예를 들어, Amazon S3™ 클라우드에서 원격 파일을 읽으려면:

data = tdmsread("s3://bucketname/path_to_file/data.tdms");

예: "airlinesmall.tdms"

데이터형: char | string

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: ChannelGroupName="Torque",ChannelNames="Torque1"

지원되는 이름-값 쌍은 다음과 같습니다.

ChannelGroupName — 읽을 채널을 포함하는 채널 그룹

string | char

읽을 채널을 포함하는 채널 그룹으로, string형 또는 문자형 벡터로 지정됩니다.

예: "Torque"

데이터형: string | char

ChannelNames — 읽을 채널 이름

char | string | 셀

읽을 채널의 이름으로, string형, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 채널은 ChannelGroupName로 지정된 채널 그룹에 있어야 합니다.

예: ["Torque1" "Torque2"]

데이터형: char | string | cell

RowTimes — 테이블의 행과 관련된 시간

datetime | 기간 | 채널 이름

테이블의 행과 연관된 시간으로, 선택된 시간 채널 이름, datetime형 벡터 또는 duration형 벡터로 지정됩니다. 이 옵션을 지정하면 함수가 타임테이블로 구성된 셀형 배열을 출력합니다. 각 시간 요소는 출력 타임테이블의 행에 레이블을 지정합니다.

예: duration(seconds([1:1000]/1000))

데이터형: datetime | duration | string

StartTime — 출력 타임테이블 시작 시간

datetime | 기간

출력 타임테이블의 시작 시간은 타임테이블의 첫 번째 데이터 레코드의 시간을 나타내는 스칼라 날짜시간 또는 기간으로 지정됩니다.

예: StartTime=seconds(60)

데이터형: datetime | duration

SampleRate — 출력 타임테이블의 샘플 레이트

double

출력 타임테이블의 샘플 레이트로, 초당 샘플을 나타내는 양의 스칼라 double형으로 지정됩니다.

예: SampleRate=1000

데이터형: double

TimeStep — 출력 타임테이블의 스텝 시간

기간 | calendarDuration

출력 타임테이블의 시간 스텝으로, 데이터 레코드 간의 시간 범위를 나타내는 스칼라 기간 또는 calendarDuration으로 지정됩니다.

예: TimeStep=seconds(0.01)

데이터형: duration | calendarDuration

출력 인수

data — 출력 데이터

테이블로 구성된 셀형 배열

출력 데이터로, TDMS 파일의 데이터 레코드가 포함된 테이블 또는 타임테이블로 구성된 셀형 배열로 반환됩니다. 셀 배열의 각 요소는 채널 그룹에 대한 테이블 또는 타임테이블입니다. 셀 배열 인덱스는 채널 그룹 번호에 해당합니다.

첫 번째 샘플의 시작 시간이 0이고 샘플 시간이 해당 시간(기간)을 기준으로 하는 경우, 타임테이블에 반환되는 샘플 시간은 01/01/1904 00:00:00.00 UTC(그레고리력을 사용하고 윤초는 무시)에 해당하는 로컬 시간대의 에포크 이후 초를 기준으로 합니다. 자세한 내용은 TDMS 파일 형식 내부 구조 항목을 참조하십시오.

버전 내역

R2022a에 개발됨

참고 항목

함수

• tdmsinfo | tdmsreadprop | tdmswrite | tdmswriteprop | tdmsconvert