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

tdmswrite

TDMS 파일에 데이터 쓰기

R2022b 이후

페이지 내 모두 축소

구문

tdmswrite(tdmsfile,tdmsdata)
tdmswrite(tdmsfile,tdmsdata,Name=Value)

설명

tdmswrite 함수를 사용하면 테이블 또는 타임테이블 데이터를 새 TDMS 파일이나 기존 TDMS 파일에 기록할 수 있습니다.

tdmswrite(tdmsfile,tdmsdata)는 테이블, 타임테이블 또는 테이블이나 타임테이블로 구성된 셀형 배열의 데이터를 지정한 TDMS 파일에 씁니다. 각 테이블은 파일에 새로운 채널 그룹으로 쓰이며, 쓸 때마다 채널 그룹 이름이 자동으로 증가합니다.

tdmswrite(tdmsfile,tdmsdata,Name=Value)는 하나 이상의 이름-값 인수로 지정된 채널 그룹 이름 및 시간 채널 형식 레이아웃과 같은 추가 옵션을 사용하여 데이터를 씁니다. 예를 들어, ChanGrp1라는 이름의 기존 채널 그룹에 데이터를 쓰려면 ChannelGroupNames를 "ChanGrp1"로 설정하십시오.

이 함수는 Linux®의 Debian® 배포판 (R2026a 이후)과 Windows®에서 지원됩니다.

예제

예제

모두 축소

지정된 TDMS 파일에 데이터를 씁니다. 기본 채널 그룹을 사용하거나 채널 그룹 이름을 직접 지정할 수 있습니다.

데이터로 구성된 테이블 또는 타임테이블 T를 sinewave.tdms라는 이름의 TDMS 파일의 새 채널 그룹에 씁니다. 

tdmswrite("sinewave.tdms",T);

데이터 T에 대한 테이블 또는 타임테이블을 TDMS 파일 내의 특정 채널 그룹에 씁니다. 채널 그룹이 존재하지 않으면 파일에 추가됩니다.

tdmswrite("sinewave.tdms", T, ChannelGroupNames="MeasuredData");

TDMS 파일 내의 여러 채널 그룹에 두 개의 데이터 테이블을 씁니다.

tdmswrite("sinewave.tdms", {T1,T2}, ChannelGroupNames=["Measurement1" "Measurement2"]);

입력 인수

모두 축소

TDMS 파일 이름으로, string형으로 지정됩니다.

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

예: "sample332.tdms"

데이터형: char | string

TDMS 데이터로, 테이블, 타임테이블 또는 테이블과 타임테이블의 셀형 배열로 지정됩니다. 또는 T1,T2,T3와 같이 여러 테이블이나 타임테이블을 일련의 인수로 지정할 수도 있습니다.

기간 타임테이블의 경우, 표기된 시작 시간은 0입니다. tdmsread로 이 파일을 읽을 때, 시작 시간은 1904년 1월 1일 00:00:00.00 UTC에 해당하는 현지 시간대의 Epoch입니다(그레고리력을 사용하며 윤초는 무시함). 자세한 내용은 TDMS 파일 형식 내부 구조 항목을 참조하십시오.

데이터형: table | timetable | cell

이름-값 인수

모두 축소

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

예: tdmswrite("sinewave.tdms", {T1,T2}, ChannelGroupNames=["ChannelGroup1" "ChannelGroup2"], TimeChannel="none")

채널 그룹 이름으로, 문자열 또는 문자형 벡터로 지정됩니다. 여러 테이블을 작성할 때는 채널 그룹 이름 배열을 사용하십시오.

  • TDMS 파일에 해당 채널 그룹이 존재하지 않으면, 새로운 채널 그룹이 생성됩니다.

  • 채널 그룹이 존재하는 경우, 데이터는 테이블 변수와 이름이 일치하는 채널에 추가됩니다. 기존 채널 이름으로 이미 지정되지 않은 테이블 변수에 대해서는 해당 채널 그룹에 새로운 채널이 추가됩니다.

예: tdmswrite("sinewave.tdms", T, ChannelGroupNames="ChannelGroup1")

데이터형: char | string | cell

시간 채널 형식 레이아웃으로, "single" 또는 "none" 값을 갖는 문자열 또는 문자형 벡터로 지정됩니다. 이 형식은 타임테이블에서 데이터를 기록할 때 측정 시간이 TDMS 파일에 어떻게 포함되는지를 지정합니다. 타임테이블이 아닌 일반 테이블에서 TDMS 파일에 데이터를 기록하는 경우, TimeChannel 설정은 무시됩니다.

  • "single" 값(디폴트 값)을 지정하면 각 측정값마다 타임스탬프가 포함된 단일 채널이 추가됩니다. 이는 타이밍이 불규칙한 타임테이블에 적합하며, 각 측정값이 고유한 날짜/시간 또는 지속 시간을 가지며, 채널 그룹 내의 모든 채널에서 이 정보를 공유하는 경우에 사용됩니다. 이 Time 채널은 입력 타임테이블의 Time 변수에서 파생된 것입니다.

  • "none" 값은 채널 속성 wf_start_time와 wf_increment에 각각 시작 시간과 스텝 시간만 추가합니다. 고정된 샘플 레이트를 사용하는 정규 타임테이블에 적합한 이 옵션을 사용하면 TDMS 파일의 크기를 줄일 수 있습니다.

참고

정기적인 시간 간격을 가진 타임테이블에서 TDMS 파일에 데이터를 기록할 때 성능을 높이려면 TimeChannel="none"를 사용하십시오.

예: tdmswrite("sinewave.tdms", T, TimeChannel="none")

데이터형: char | string

버전 내역

R2022b에 개발됨

모두 확장

참고 항목

함수

외부 웹사이트