tdmsreadprop

TDMS ファイルからの単一行テーブルとしてのプロパティの読み取り

R2022a 以降

構文

props = tdmsreadprop(tdmsfile)

props = tdmsreadprop(tdmsfile,Name=Value)

説明

props = tdmsreadprop(tdmsfile) は、指定された TDMS ファイルからプロパティの table を返します。

props = tdmsreadprop(tdmsfile,Name=Value) は、名前と値のペアを使用して情報をフィルター処理し、特定のプロパティを取得します。

例

TDMS ファイルからのプロパティの読み取り

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"

1 つのチャネル グループのプロパティを読み取ります。

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

入力引数

tdmsfile — TDMS ファイル名

string

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"

次の名前と値のペアがサポートされています。

ChannelGroupName — 読み取るチャネルが含まれているチャネル グループ

string | char

読み取るチャネルが含まれているチャネル グループ。string または文字ベクトルとして指定します。

例: ChannelGroupName="Torque"

データ型: string | char

ChannelName — 読み取るチャネルの名前

char | string

読み取るチャネルの名前。string または文字ベクトルとして指定します。チャネルは、ChannelGroupName で指定されたチャネル グループに含まれていなければなりません。

例: ChannelName="Torque2"

データ型: char | string

PropertyNames — 読み取るプロパティ名

string | char | cell

読み取るプロパティ名。string、string 配列、文字ベクトル、または文字ベクトルの cell 配列として指定します。サポートされるプロパティは、ファイルの内容、および指定したチャネル グループとチャネルによって異なります。

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

データ型: char | string | cell

出力引数

props — TDMS ファイルからのプロパティの table

table

TDMS ファイル内のプロパティ。table として返されます。

制限

• TDMS 関数は、Windows^® プラットフォームでのみサポートされます。

バージョン履歴

R2022a で導入

参考

関数

• tdmsread | tdmsinfo