tdmsinfo

TDMS ファイルに関する情報

R2022a 以降

構文

info = tdmsinfo(tdmsfile)

説明

info = tdmsinfo(tdmsfile) は、TDMS ファイルに関する一般情報 (ファイル名、場所、説明、作成者、バージョン、チャネルのリストなど) が格納されたプロパティをもつ TdmsInfo オブジェクトを返します。

例

TDMS ファイルに関する情報の取得

TDMS ファイルとそのチャネルに関する情報を取得します。

info = tdmsinfo("Turbine_003.tdms")

info = 

  TdmsInfo with properties:

           Path: "C:\data\tdms\Turbine_003.tdms"
           Name: "Turbine_003"
    Description: "Test the Acceleration, Force and Torque of Turbine"
          Title: "Turbine Tests"
         Author: "xyz"
        Version: "2.0"
    ChannelList: [6×8 table]

ファイル内のチャネル情報を表示します。

>> info.ChannelList

ans =

  6×8 table

    ChannelGroupNumber    ChannelGroupName    ChannelGroupDescription      ChannelName      ChannelDescription     Unit      DataType    NumSamples
    __________________    ________________    _______________________    _______________    __________________    _______    ________    __________

            1              "Acceleration"        "CGAcceleration"        "Acceleration1"     "from Clipboard"     "m/s^2"    "Double"       3312   
            1              "Acceleration"        "CGAcceleration"        "Acceleration2"     "from Clipboard"     "m/s^2"    "Double"       3312   
            2              "Force"               "CGForce"               "Force1"            "from Clipboard"     "N"        "Double"       3312   
            2              "Force"               "CGForce"               "Force2"            "from Clipboard"     "N"        "Double"       3312   
            3              "Torque"              "CGTorque"              "Torque1"           "from Clipboard"     "Nm"       "Double"       3312   
            3              "Torque"              "CGTorque"              "Torque2"           "from Clipboard"     "Nm"       "Double"       3312

入力引数

tdmsfile — TDMS ファイル名

string

TDMS ファイル名。string として指定します。

ローカル ファイルの場合、ファイルの名前と拡張子を含む絶対パスまたは相対パスを使用します。MATLAB^® パス上のファイルを指定することもできます。

インターネット上のファイルの場合は URL を指定します。たとえば、Amazon S3™ クラウドからリモート ファイルを読み取るには次のようにします。

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

例: "airlinesmall.tdms"

データ型: char | string

出力引数

info — TDMS ファイルに関する情報

TdmsInfo オブジェクト

TDMS ファイルに関する情報。以下のプロパティをもつ TdmsInfo オブジェクトとして返されます。

Property	型	説明
Path	string	ファイルの絶対パス
Name	string	TDMS ファイルの名前の属性
Description	string	TDMS ファイルの説明の属性
Title	string	TDMS ファイルのタイトルの属性
Author	string	TDMS ファイルの作成者の属性
Version	string	TDMS ファイルのバージョンの属性
ChannelList	table	TDMS のチャネルとチャネル グループの属性

ChannelList プロパティ値は、以下の変数をもつ table です。

table 変数	型	メモ
ChannelGroupNumber	double	内部で作成された、チャネル グループの表示用インデックス
ChannelGroupName	string
ChannelGroupDescription	string
ChannelName	string
ChannelDescription	string
Unit	string	チャネル データの単位
DataType	string	ファイルに含まれる TDMS データの型
NumSamples	uint64	チャネル内のサンプルの数

制限

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

バージョン履歴

R2022a で導入

参考

関数

• tdmsread | tdmsreadprop