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

mdfDatastore

MDF ファイルのコレクション用のデータ ストア

このページをすべて展開する

説明

MDF データストア オブジェクトを使用して、MDF ファイルのコレクションからデータにアクセスします。

作成

構文

mdfds = mdfDatastore(location)
mdfds = mdfDatastore(__,Name=Value,Name=Value,...)

説明

mdfds = mdfDatastore(location) は、location によって指定されたフォルダー内の MDF ファイルまたはファイルのコレクションに基づいて MDFDatastore を作成します。フォルダー内の拡張子が .mdf、.dat、または .mf4 のすべてのファイルが含まれます。

mdfds = mdfDatastore(__,Name=Value,Name=Value,...) は、オプションの名前と値のペアを使用して、mdfds の関数オプションとプロパティを指定します。

例

入力引数

すべて展開する

文字列、文字ベクトル、cell 配列、またはオブジェクトとして指定された MDF データストア ファイルの場所。

  • DsFileSet オブジェクト — DsFileSet オブジェクトを指定できます。詳細については、matlab.io.datastore.DsFileSetを参照してください。

  • FileSet オブジェクト — location を FileSet オブジェクトとして指定できます。場所を FileSet オブジェクトとして指定すると、パスまたは DsFileSet オブジェクトを指定する場合と比較して、データストアの構築時間が短縮されます。詳細については、matlab.io.datastore.FileSetを参照してください。

  • ファイル パス - 単一のファイル パスを文字ベクトルまたは文字列スカラーとして指定できます。複数のファイル パスを、文字ベクトルの cell 配列または文字列配列として指定できます。

    パスは相対パス、絶対パス、またはリモート サーバーへの URL にすることができます。location 引数にはワイルドカード文字 * を含めることができます。location がフォルダーを指定する場合、デフォルトでは、データストアにはそのフォルダー内の拡張子が .mdf、.dat、または .mf4 のすべてのファイルが含まれます。FileExtensions パラメータを使用して、このリストを制限または拡張できます。

    ファイル パスとしての location は、次のいずれかの形式を取ることができます。

    データの場所

    形式

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

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

    例: ["myFile2.mf4","myFile3.mf4"]

    例: "myDataFolder"

    その他のフォルダー

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

    例: "C:\myFolder\myFile*.mf4"

    例: "\myDataFolder"

    リモートの場所

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

    scheme://path_to_location

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

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

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

    例: "s3://bucketname/path_to_file/myMdfData/"

データ型: string | char | cell | DsFileSet

名前と値の引数

すべて展開する

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

これらのペアはファイル情報またはオブジェクト プロパティ を設定します。許可されるオプションは、IncludeSubfolders、FileExtensions、およびプロパティ ReadRaw、ReadSize、SelectedChannelGroupNumber、および SelectedChannelNames です。

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

例: SelectedChannelNames="Counter_B4"

論理として指定されたサブフォルダー内のファイルを含めます。各フォルダー内のファイルとサブフォルダー内のファイルを再帰的に含めるには、true を指定します。

例: IncludeSubfolders=true

データ型: logical

MDF データストアに含めるファイル名のカスタム拡張子。文字列、文字列配列、文字ベクトル、または文字ベクトルの cell 配列として指定します。デフォルトでは、サポートされている拡張子には .mdf、.dat、および .mf4 が含まれます。ファイルにカスタム拡張子または非標準拡張子が付いている場合は、この名前と値の設定を使用して、それらの拡張子を持つファイルを含めます。

例: FileExtensions=[".myformat1",".myformat2"]

データ型: char | cell

プロパティ

すべて展開する

この プロパティ は読み取り専用です。

最初の MDF ファイルに存在するすべてのチャネル グループが、mdfChannelGroupInfo 関数によって返されるものと同じ形式のテーブルとして返されます。

データ型: table

この プロパティ は読み取り専用です。

最初の MDF ファイルに存在するすべてのチャネルが、mdfChannelInfo 関数によって返されるのと同じ形式のテーブルとして返されます。

読み取り対象となるチャネルは、MDF データストアの各ファイル内で同じ名前を持ち、同じチャネル グループに属している必要があります。

データ型: table

データストアに含まれるファイル。文字ベクトル、文字列、または cell 配列として指定されます。

例: ["file1.mf4","file2.mf4"]

データ型: char | string | cell

true または false として指定された生のデータ値を読み取ります。true を指定した場合、データは生の値として読み取られます。false を指定した場合、データは物理値として読み取られます。既定値は false です。

例: ReadRaw=true

データ型: logical

read 関数によって返されるデータのサイズ。"file"、数値、または期間として指定されます。文字列値 "file" はファイル全体を読み取ります。数値の double 値は読み取るレコードの数を指定します。期間値は読み取る時間の範囲を指定します。

後で ReadSize プロパティ値の型を変更すると、データストアがリセットされます。

例: 50

データ型: double | string | char | duration

読み取るチャネル グループ。数値スカラー値として指定します。

例: 1

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

読み取るチャネルの名前。文字列、文字列配列、文字ベクトル、または cell 配列として指定されます。

読み取り対象となるチャネルは、MDF データストアの各ファイル内で同じ名前を持ち、同じチャネル グループに属している必要があります。特に指定がない限り、デフォルト値は、チャネル グループ 1 内のチャネル名をアルファベット順に並べた値になります。

例: "Counter_B4"

データ型: char | string | cell

オブジェクト関数

readMDF データストア内のデータを読み取る
readallMDFデータストア内のすべてのデータを読み取る
previewMDF データストアからのデータのサブセット
resetMDFデータストアを初期状態にリセット
hasdataMDFデータストアから読み取れるデータがあるかどうかを確認します
partitionMDFデータストアのパーティション
numpartitionsMDFデータストアのパーティション数
combine (MATLAB)複数のデータストアのデータを統合
transform (MATLAB)データストアの変換
isPartitionable (MATLAB)データストアが分割可能かどうかを判別
isShuffleable (MATLAB)データストアがシャッフル可能かどうかを判別

例

すべて折りたたむ

サンプル ファイル CANape.MF4 から MDF データストアを作成し、それを timetable に読み込みます。

mdfds = mdfDatastore("C:\myMDFData\CANape.MF4");
while hasdata(mdfds)
    m = read(mdfds);
end

バージョン履歴

R2017b で導入

すべて展開する

参考

トピック