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

tdmsreadprop

TDMS 파일에서 속성을 단일 행 테이블로 읽기

R2022a 이후

페이지 내 모두 축소

구문

props = tdmsreadprop(tdmsfile)
props = tdmsreadprop(tdmsfile,Name=Value)

설명

props = tdmsreadprop(tdmsfile)는 지정된 TDMS 파일에서 속성 테이블을 반환합니다.

props = tdmsreadprop(tdmsfile,Name=Value)는 이름-값 쌍을 사용하여 정보를 필터링하여 특정 속성을 얻습니다.

예제

예제

모두 축소

TDMS 파일의 파일 수준 속성을 읽습니다.

props = tdmsreadprop("Turbine_003.tdms")
props =

  1×7 table

        name              title         author                        description                                   datetime                datestring     timestring
    _____________    _______________    ______    ____________________________________________________    _____________________________    ____________    __________

    "Turbine_003"    "Turbine Tests"    "xyz"     "Test the Acceleration, Force and Torque of Turbine"    2021-10-18 01:57:17.000000000    "10/18/2021"    "11:27:17"

하나의 채널 그룹의 속성을 읽습니다.

props = tdmsreadprop("Turbine_003.tdms",ChannelGroupName="Torque")
props =

  1×2 table

      name      description
    ________    ___________

    "Torque"    "CGTorque"

범위를 좁혀 특정 채널의 속성을 확인합니다. 이 경우 채널은 해당 채널 그룹보다 더 많은 속성을 가집니다.

props = tdmsreadprop("Turbine_003.tdms",ChannelGroupName="Torque",ChannelName="Torque2")
props =

  1×19 table

      name        datatype        description       unit_string    displaytype        monotony           novaluekey       ResultStatArithMean    ResultStatMax    ResultStatMin    ResultStatSqrMean    ResultStatSum    wf_increment    wf_samples    wf_start_offset            wf_start_time            wf_time_pref    wf_xname    wf_xunit_string
    _________    ___________    ________________    ___________    ___________    ________________    ________________    ___________________    _____________    _____________    _________________    _____________    ____________    __________    _______________    _____________________________    ____________    ________    _______________

    "Torque2"    "DT_DOUBLE"    "from Clipboard"       "Nm"         "Numeric"     "not calculated"    "not calculated"        -6.7843e-06           1.4651           -1.6662            0.12794            -2.2049          0.0001          3312              0           2012-07-31 18:00:00.000000000     "relative"      "Time"           "s"

파일의 특정 속성에 따라 필터링합니다.

props = tdmsreadprop("Turbine_003.tdms",PropertyNames=["name" "title" "author" "description"])
props =

  1×4 table

        name              title         author                        description                     
    _____________    _______________    ______    ____________________________________________________

    "Turbine_003"    "Turbine Tests"    "xyz"     "Test the Acceleration, Force and Torque of Turbine"

채널의 시작 시간과 스텝 주기를 가져옵니다.

props = tdmsreadprop("Turbine_003.tdms",ChannelGroupName="Torque",ChannelName="Torque2",...
    PropertyNames=["wf_start_time" "wf_increment"])
props =

  1×2 table

    wf_increment            wf_start_time        
    ____________    _____________________________

       0.0001       2012-07-31 18:00:00.000000000

wf_increment 값의 역수를 취함으로써 샘플 레이트를 도출할 수 있습니다.

rate = 1/props{1,"wf_increment"}
rate =

       10000

입력 인수

모두 축소

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

로컬 파일의 경우 파일 이름과 확장자가 포함된 전체 경로나 상대 경로를 사용하십시오. 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",ChannelName="Torque2"

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

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

예: ChannelGroupName="Torque"

데이터형: string | char

읽을 채널의 이름으로, string형 또는 문자형 벡터로 지정됩니다. 채널은 ChannelGroupName로 지정된 채널 그룹에 속해야 합니다.

예: ChannelName="Torque2"

데이터형: char | string

읽을 속성 이름으로, string형, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 지원되는 속성은 파일 내용과 지정된 채널 그룹 및 채널에 따라 달라집니다.

예: PropertyNames=["name" "description" "wf_start_time"]

데이터형: char | string | cell

출력 인수

모두 축소

TDMS 파일에 포함된 속성으로, 테이블로 반환됩니다.

버전 내역

R2022a에 개발됨

참고 항목

함수

도움말 항목