メインコンテンツ

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

mdfChannelInfo

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

R2023a 以降

    説明

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

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

    すべて折りたたむ

    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     
    

    入力引数

    すべて折りたたむ

    必要な完全パスまたは相対パスを含む文字列または文字ベクトルとして指定された 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 Storagewasb, wasbs
    HDFS™hdfs

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

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

    データ型: string | char

    名前と値の引数

    すべて折りたたむ

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

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

    例: GroupNumber=2

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

    例: GroupNumber=[1,2]

    データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

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

    データ型: string | char | cell

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

    例: AdditionalMetadata=true

    データ型: logical

    出力引数

    すべて折りたたむ

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

    バージョン履歴

    R2023a で導入

    すべて展開する