このページは機械翻訳を使用して翻訳されました。最新版の英語を参照するには、ここをクリックします。

mdfChannelInfo

MDF ファイルからチャネルのメタデータを取得する

R2023a 以降

ページ内をすべて折りたたむ

構文

infoTable = mdfChannelInfo(mdfFileName)

infoTable = mdfChannelInfo(___,Name=Value)

説明

infoTable = mdfChannelInfo(mdfFileName) は、指定された MDF ファイル内のすべてのチャネルに関する情報のテーブルを返します。

infoTable = mdfChannelInfo(___,Name=Value) では、指定された名前と値の引数を使用して特定のチャネルおよびチャネルグループをフィルターし、返されるメタデータの量を決定できます。

例

すべて折りたたむ

MDF ファイルからチャネル情報を取得する

MDF ファイル内のチャネル情報にアクセスします。

すべてのチャネルで情報を入手します。

ci = mdfChannelInfo("VehicleData.mf4")

ci =
  12×13 table

          Name           GroupNumber    GroupNumSamples    GroupAcquisitionName                                   GroupComment                                    GroupSourceName    GroupSourcePath    DisplayName       Unit          Comment     ExtendedNamePrefix    SourceName     SourcePath 
    _________________    ___________    _______________    ____________________    ___________________________________________________________________________    _______________    _______________    ___________    ___________    ___________   __________________    ___________    ___________

    "AirFlow"                 2              92033             <undefined>         Simulation of engine gas dynamics.                                               <undefined>        <undefined>          ""         g/s            <undefined>      <undefined>        <undefined>    <undefined>
    "Brake"                   1                751             <undefined>         Simulation of an automatic transmission controller during passing maneuver.      <undefined>        <undefined>          ""         ft*lbf         <undefined>      <undefined>        <undefined>    <undefined>
    "EngineRPM"               1                751             <undefined>         Simulation of an automatic transmission controller during passing maneuver.      <undefined>        <undefined>          ""         rpm            <undefined>      <undefined>        <undefined>    <undefined>
    "FuelRate"                2              92033             <undefined>         Simulation of engine gas dynamics.                                               <undefined>        <undefined>          ""         g/s            <undefined>      <undefined>        <undefined>    <undefined>
    "Gear"                    1                751             <undefined>         Simulation of an automatic transmission controller during passing maneuver.      <undefined>        <undefined>          ""         <undefined>    <undefined>      <undefined>        <undefined>    <undefined>
    "ImpellerTorque"          1                751             <undefined>         Simulation of an automatic transmission controller during passing maneuver.      <undefined>        <undefined>          ""         ft*lbf         <undefined>      <undefined>        <undefined>    <undefined>
    "OutputTorque"            1                751             <undefined>         Simulation of an automatic transmission controller during passing maneuver.      <undefined>        <undefined>          ""         ft*lbf         <undefined>      <undefined>        <undefined>    <undefined>
    "Throttle"                1                751             <undefined>         Simulation of an automatic transmission controller during passing maneuver.      <undefined>        <undefined>          ""         %              <undefined>      <undefined>        <undefined>    <undefined>
    "TransmissionRPM"         1                751             <undefined>         Simulation of an automatic transmission controller during passing maneuver.      <undefined>        <undefined>          ""         rpm            <undefined>      <undefined>        <undefined>    <undefined>
    "VehicleSpeed"            1                751             <undefined>         Simulation of an automatic transmission controller during passing maneuver.      <undefined>        <undefined>          ""         mph            <undefined>      <undefined>        <undefined>    <undefined>
    "time"                    1                751             <undefined>         Simulation of an automatic transmission controller during passing maneuver.      <undefined>        <undefined>          ""         s              <undefined>      <undefined>        <undefined>    <undefined>
    "time"                    2              92033             <undefined>         Simulation of engine gas dynamics.                                               <undefined>        <undefined>          ""         s              <undefined>      <undefined>        <undefined>    <undefined>

特定のチャネルの情報を表示します。

ci = mdfChannelInfo("VehicleData.mf4",Channel="*Torque")

ci =
  2×13 table

          Name          GroupNumber    GroupNumSamples    GroupAcquisitionName                                   GroupComment                                    GroupSourceName    GroupSourcePath    DisplayName     Unit       Comment      ExtendedNamePrefix    SourceName     SourcePath 
    ________________    ___________    _______________    ____________________    ___________________________________________________________________________    _______________    _______________    ___________    ______    ___________    __________________    ___________    ___________

    "ImpellerTorque"         1               751              <undefined>         Simulation of an automatic transmission controller during passing maneuver.      <undefined>        <undefined>          ""         ft*lbf    <undefined>       <undefined>        <undefined>    <undefined>
    "OutputTorque"           1               751              <undefined>         Simulation of an automatic transmission controller during passing maneuver.      <undefined>        <undefined>          ""         ft*lbf    <undefined>       <undefined>        <undefined>    <undefined>

1 つのチャネルグループ内のチャネル情報を表示します。

ci = mdfChannelInfo("VehicleData.mf4",GroupNumber=2)

ci =
  3×13 table

       Name       GroupNumber    GroupNumSamples    GroupAcquisitionName               GroupComment               GroupSourceName    GroupSourcePath    DisplayName    Unit      Comment      ExtendedNamePrefix    SourceName     SourcePath 
    __________    ___________    _______________    ____________________    __________________________________    _______________    _______________    ___________    ____    ___________    __________________    ___________    ___________

    "AirFlow"          2              92033             <undefined>         Simulation of engine gas dynamics.      <undefined>        <undefined>          ""         g/s     <undefined>       <undefined>        <undefined>    <undefined>
    "FuelRate"         2              92033             <undefined>         Simulation of engine gas dynamics.      <undefined>        <undefined>          ""         g/s     <undefined>       <undefined>        <undefined>    <undefined>
    "time"             2              92033             <undefined>         Simulation of engine gas dynamics.      <undefined>        <undefined>          ""         s       <undefined>       <undefined>        <undefined>    <undefined>

複数のチャネルの一致に関する追加のメタデータを要求します。最初の列と追加のテーブル列のみを表示します。

ci = mdfChannelInfo("VehicleData.mf4",Channel=["*Torque","*Rate"],AdditionalMetadata=true);
ci(:,[1,14:25])

ans =
  3×13 table

          Name             Type        SyncType        DataType        NumBits    ComponentType    CompositionType    ConversionType    SourceComment    SourceType     SourceBusType    SourceBusChannelNumber    SourceSimulated
    ________________    ___________    ________    ________________    _______    _____________    _______________    ______________    _____________    ___________    _____________    ______________________    _______________

    "FuelRate"          FixedLength      None      RealLittleEndian      64           None              None           Unspecified           ""          Unspecified     Unspecified               0                    false     
    "ImpellerTorque"    FixedLength      None      RealLittleEndian      64           None              None           Unspecified           ""          Unspecified     Unspecified               0                    false     
    "OutputTorque"      FixedLength      None      RealLittleEndian      64           None              None           Unspecified           ""          Unspecified     Unspecified               0                    false

入力引数

すべて折りたたむ

`mdfFileName` — MDFファイル名
string | 文字ベクトル

必要な完全パスまたは相対パスを含む文字列または文字ベクトルとして指定された MDF ファイル名。URL を使用してリモートサーバー上のファイルを指定できます。

アクセスする場所に応じて、mdfFileName は次のいずれかの形式になります。

位置

形式

現在のフォルダまたはMATLAB^®パス

現在のフォルダーまたは MATLAB パス内のファイルにアクセスするには、ファイル拡張子を含む filename でファイル名を指定します。

例: "myMdfFile.mf4"

その他のフォルダー

現在のフォルダー以外のフォルダー内のファイルにアクセスするには、filename で完全パス名または相対パス名を指定します。

例: "C:\myFolder\myMdfFile.mf4"

例: "\dataDir\myMdfFile.mf4"

リモートの場所

リモートの場所にあるファイルにアクセスするには、filename に、次の形式の Uniform Resource Locator (URL) として指定されたファイルの完全なパスが含まれている必要があります。

scheme://path_to_file/myMdfFile.mf4

リモートの場所に基づいて、scheme には次の表の値のいずれかを指定できます。

リモートの場所	`scheme`
Amazon S3™	`s3`
Windows Azure^® Blob Storage	`wasb`, `wasbs`
HDFS™	`hdfs`

詳細については、リモートデータの操作を参照してください。

例: "s3://bucketname/path_to_file/myMdfFile.mf4"

データ型: string | char

名前と値の引数

すべて折りたたむ

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: GroupNumber=2

`GroupNumber` — チャネルグループ番号
数値

チャネルグループ番号。1 つのグループの場合は数値スカラーとして指定し、複数のグループの場合は数値ベクトルとして指定します。この関数は、指定されたチャネルグループ内でのみ見つかったチャネルを返します。指定しない場合は、すべてのチャネルグループのメタデータが返されます。

例: GroupNumber=[1,2]

`Channel` — チャネル名
string | char | cell

チャネル名は、文字列または文字列の配列、あるいは文字ベクトルまたは文字ベクトルの cell 配列として指定されます。配列を使用して、複数のチャネル名のいずれかに一致させます。ワイルドカードを使用すると部分一致が可能になります。指定しない場合は、すべてのチャネルのメタデータが返されます。

例: Channel=["*Rate","*Speed"]

データ型: string | char | cell

`AdditionalMetadata` — 追加のメタデータを返す
`false` (既定値) | `true`

true または false として指定された追加のチャネルメタデータを返します。

例: AdditionalMetadata=true

データ型: logical

出力引数

すべて折りたたむ

`infoTable` — チャネル情報
table

チャネル情報がチャネルテーブルで返されます。

バージョン履歴

R2023a で導入

すべて展開する

R2023a: リモートファイルURLのサポート

Amazon S3、Azure^® Blob Storage、HDFS などのリモートの場所に保存されている MDF ファイルデータに直接アクセスできます。

参考

関数

mdfChannelGroupInfo | mdfInfo | mdfRead

mdfChannelInfo

構文

説明

例

MDF ファイルからチャネル情報を取得する

入力引数

mdfFileName — MDFファイル名 string | 文字ベクトル

名前と値の引数

GroupNumber — チャネルグループ番号 数値

Channel — チャネル名 string | char | cell

AdditionalMetadata — 追加のメタデータを返す false (既定値) | true

出力引数

infoTable — チャネル情報 table

バージョン履歴

R2023a: リモートファイルURLのサポート

参考

関数

`mdfFileName` — MDFファイル名
string | 文字ベクトル

`GroupNumber` — チャネルグループ番号
数値

`Channel` — チャネル名
string | char | cell

`AdditionalMetadata` — 追加のメタデータを返す
`false` (既定値) | `true`

`infoTable` — チャネル情報
table