主要内容

このペ,ジの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

signalDatastore

信号コレクションのデ,タストア

説明

signalDatastoreオブジェクトを使用して,。個々のファesc escルはメモリに収まっても,コレクション全体が収まるとは限らない場合に使用します。

作成

説明

sds= signalDatastore (数据は,数据に含まれる▪▪ンメモリ入力信号をも▪▪信号デ▪タストアを作成します。

sds= signalDatastore (位置は,位置にあるmatファルのコレクションに基づいて信号デタストアを作成します。

sds= signalDatastore (___名称,值は,1以上の名前と値のペアの引数を使用して追加プロパティを指定します。

入力引数

すべて展開する

ンメモリ入力デ,タ。ベクトル,行列、timetable または cell 配列として指定します。数据の各要素は,の呼び出しごとにデ,タストアによって出力されたメンバ,です。

例:{randn (100 1);randn (120 3);randn (135 2);randn (100 1)}

デタストアに含まれるファルまたはフォルダ。パスまたはDsFileSetオブジェクトとして指定します。

  • パス——パスを文字ベクトル,文字ベクトルの细胞配列,字符串スカラーまたは字符串配列として指定します。ロカルまたはリモトのファルまたはフォルダの位置を含みます。

    • ロカルのファルまたはフォルダ-位置をファルまたはフォルダへのロカルパスとして指定します。ファイルが現在のフォルダーに存在しない場合,ローカルパスは絶対パスまたは相対パスを指定しなければなりません。指定されたフォルダのサブフォルダ内のファルは,自動的にはデタストアに含まれません。ロカルパスを指定する際,ワルドカド文字(*)を使用できます。この文字は,すべての一致するファイル,または一致するフォルダー内のすべてのファイルがデータストアに含まれることを指定します。

    • リモトのファルまたはフォルダファルまたはフォルダの絶対パスとなる位置hdfs: / / / path_to_file形式のユニフォ,ムリソ,スロケ,タ(url)として指定します。詳細にいては,リモ,トデ,タの操作を参照してください。

  • DsFileSetオブジェクト-位置DsFileSetオブジェクトとして指定することもできます。詳細にいては,matlab.io.datastore.DsFileSetを参照してください。

位置がフォルダーを表す場合,データストアにはサポートされているファイル形式のみが含まれ,他の形式は無視されます。デタストアに含めるファル拡張子のカスタムリストを指定するには,FileExtensionsプロパティを参照してください。

例:“whale.mat”

例:“. . / dir /数据/ signal.mat”

デ,タ型:字符|字符串|细胞

名前と値のペアの引数

オプションの引数名称,值のコンマ区切りペアを指定します。的名字は引数名で,价值は対応する値です。的名字は引用符で囲まなければなりません。Name1, Value1,…,的家のように,複数の名前と値のペアの引数を,任意の順番で指定できます。

例:sds = signalDatastore('C:\dir\signaldata','FileExtensions','.csv')

サブフォルダ,包含フラグ。“IncludeSubfolders”真正的またはからなるコンマ区切りのペアとして指定します。すべてのファイルとサブフォルダーを各フォルダー内に含める場合は真正的を,ファを指定します。

例:“IncludeSubfolders”,真的

デ,タ型:逻辑|

信号ファ@ @ル拡張子。“FileExtensions”と,弦スカラー,弦配列,文字ベクトル,または文字ベクトルの细胞配列で構成されるコンマ区切りのペアとして指定します。

読み取り関数を指定しない場合,“FileExtensions”.matがmatファaaplルを読み取る,または. csvがCSVファCSVルを読み取るようにのみ設定できます。“FileExtensions”を省略した場合,指定した場所にmatファescルがあれば既定値は.matになり,指定した場所にCSVファCSVルがあれば“FileExtensions”の既定値は. csvになります。

Matファe.c.ルとCSVファe.c.ルがどe.c.らも存在しない場合,signalDatastoreは既定の関数でエラ,となります。関数ReadFcnを使用してカスタム関数を指定することにより,他のタaaplプのファaaplルを読み取ります。

ファ电子邮箱ル拡張子を指定しない場合,signalDatastoreは,既定で読み取る拡張子を決定するためにファ。解析時間が発生しないように拡張子を指定します。

例:' FileExtensions ', ' . csv”

デ,タ型:字符串|字符|细胞

これらの名前と値のペアに加え,このペ,ジの任意のプロパティ(文件プロパティを除く)を名前と値のペアとして指定することもできます。

プロパティ

すべて展開する

ンメモリデ,タ

メンバ,名。细胞配列として指定します。入力データのメンバー名の長さは、数据细胞配列の長さと等しくなければなりません。このプロパティは、デ、タストアが、ンメモリデ、タを含む場合にのみ適用されます。

信号メンバ,デ,タ。字符串スカラまたは字符串配列として指定します。入力データのメンバー名の長さは、数据细胞配列の長さと等しくなければなりません。このプロパティは、デ、タストアが、ンメモリデ、タを含む場合にのみ適用されます。

ファ▪▪ルデ▪▪タ

デタストアに含まれるファル。字符串または文字ベクトルのcell配列として指定します。cell 配列内の各文字ベクトルは、ファイルへの絶対パスを表します。signalDatastore内の引数位置は,デ,タストア作成時に文件を定義します。このプロパティは、デ、タストアがファ、ルデ、タを含む場合にのみ適用されます。

デ,タ型:字符串|字符|细胞

デ,タを読み取る関数。関数ハンドルとして指定します。この関数は、入力としてファイル名を取得した後、対応するデータを出力しなければなりません。たとえば、customreaderがデータを読み取るために指定された関数である場合,この関数は次のようなシグネチャをもたなければなりません。

函数[data,info] = customreader(filename)…结束

信号デ,タは変数数据に出力されます。変数信息は,時間情報およびファ。

例:@customreader

デ,タ型:function_handle

代替ファ▪▪ルシステムのル▪▪トパス。“AlternateFileSystemRoots”と,字符串ベクトルまたは单元格配列から構成されるコンマ区切りのペアとして指定します。データストアはローカルマシンに作成するが,(オペレーティングシステムが異なる可能性のある)別のマシン上のデータにアクセスして処理する必要がある場合,“AlternateFileSystemRoots”を使用します。并行计算工具箱™とMATLAB®并行服务器™を使用してデータを処理する場合,およびデータをローカルマシンに保存するのに加えて,そのデータのコピーを異なるプラットフォームのクラウドやクラスターマシンで利用できるようにする場合も,“AlternateFileSystemRoots”を使用してル,トパスを関連付けなければなりません。

  • 互いに等価なル,トパスのセットを関連付けるには,“AlternateFileSystemRoots”を字符串ベクトルとして指定します。次に例を示します。

    [" Z: \数据集”、“/ mynetwork /数据集”)

  • データストアに対して等価なルートパスの複数のセットを関連付けるには,各行が等価なルートパスのセットを表す複数の行を含んだ细胞配列として“AlternateFileSystemRoots”を指定します。细胞配列の各行を、string ベクトル、または文字ベクトルの cell 配列のいずれかとして指定します。次に例を示します。

    • “AlternateFileSystemRoots”を字符串ベクトルの单元格配列として指定します。

      {[Z: \“数据集”、“/ mynetwork /数据集”);…[" Y: \数据集”、“/ mynetwork2 /数据集”、“年代:\数据集”)}

    • または,“AlternateFileSystemRoots”を文字ベクトルのcell配列のcell配列として指定します。

      {{“Z: \数据集”、“mynetwork /数据集”},…{“Y: \数据集”,“mynetwork2 /数据集”,年代:\数据集的}}

“AlternateFileSystemRoots”の値は次の条件を満たさなければなりません。

  • 1以上の行を含む。各行は等価なルート パスのセットを指定する。

  • 各行は複数のル,トパスを指定する。各ルート パスは少なくとも 2 文字を含まなければならない。

  • ル,トパスは一意であり,互いのサブフォルダ,ではない。

  • ファ▪▪ルの場所を指すル▪トパスエントリを少なくとも1▪▪含む。

詳細にいては,異なるマシンまたはクラスタ,で処理するためのデ,タストアの設定を参照してください。

例:[" Z: \数据集”、“/ mynetwork /数据集”)

デ,タ型:字符串|细胞

信号ファ@ @ル内の変数名。一意の名前をもstringのスカラまたはベクトルとして指定します。ファイルに複数の変数が含まれ,読み取る信号データを保持する変数の名前を指定する場合に,このプロパティを使用します。

  • このプロパティ値が字符串スカラ,の場合,signalDatastoreは指定した変数に含まれるデ,タを返します。

  • このプロパティ値が字符串ベクトルの場合,signalDatastoreは指定した変数に含まれるデタをもcell配列を返します。

メモ

ファ电子邮箱ルの最初の変数名を決めるために,signalDatastoreは以下の手順に従います。

  • Matファルの場合:

    s = load(fileName);varNames =字段名(s);firstVar = s.(varNames{1});

  • CSVファCSVルの場合:

    opts = detectImportOptions(文件名,“PreserveVariableNames”,真正的);varNames = options . variablenames;firstVar =字符串(varNames{1});

このプロパティは,データストアがファイルデータを含み,既定の読み取り関数が使用されている場合にのみ適用されます。

サンプルレ,トを保持する変数名。字符串スカラとして指定します。このプロパティは、データストアがファイル データを含む場合にのみ適用されます。

サンプル時間値を保持する変数名。字符串スカラとして指定します。このプロパティは、データストアがファイル データを含む場合にのみ適用されます。

時間値ベクトルを保持する変数名。字符串スカラとして指定します。このプロパティは、データストアがファイル データを含む場合にのみ適用されます。

メモ

“SampleRateVariableName”“SampleTimeVariableName”および“TimeValuesVariableName”は互いに排他的です。信号デタの時間情報を保持する変数がファルに含まれる場合,これらのプロパティを使用します。指定しない場合,signalDatastoreは信号デ,タが時間情報をもたないものと仮定します。カスタム関数を指定した場合,これらのプロパティは無効になります。

@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @

サンプルレ,ト値。正の実数スカラ,またはベクトルとして指定します。

  • signalDatastore内のすべての信号に同じサンプルレ,トを指定するには,SampleRateの値をスカラ,に設定します。

  • signalDatastore内の各信号に異なるサンプルレ,トを指定するには,SampleRateの値をベクトルに設定します。

ベクトル内の要素数は,signalDatastore内の要素数と等しくなければなりません。

サンプル時間値。正のスカラ、ベクトル,持续时间スカラ,または持续时间ベクトルとして指定します。

  • signalDatastore内のすべての信号に同じサンプル時間を指定するには,SampleTimeの値をスカラ,に設定します。

  • signalDatastore内の各信号に異なるサンプル時間を指定するには,SampleTimeの値をベクトルに設定します。

ベクトル内の要素数は,signalDatastore内の要素数と等しくなければなりません。

時間値。ベクトル,持续时间ベクトル,行列,またはcell配列として指定します。

  • signalDatastore内のすべての信号に同じ時間値を指定するには,时间价值を数値ベクトルまたは持续时间ベクトルに設定します。ベクトルはセット内のすべての信号と同じ長さでなければなりません。

  • signalDatastoreの各信号が同じ時間値の信号をも,信号ごとに時間値が異なることを指定するには,时间价值を数値行列,持续时间行列,cell配列のいずれかに設定します。

    • 时间价值が行列の場合は,列数がsignalDatastoreのメンバ,数と等しくなければなりません。デ,タストア内のすべての信号は,長さが行列の行数と等しくなければなりません。

    • 时间价值がcell配列の場合は,ベクトル数がsignalDatastoreのメンバ,数と等しくなります。メンバー内のすべての信号は,長さが细胞配列内の対応するベクトルの要素数と等しくなければなりません。

によって返される信号ファ@ @ルの最大数。正の実数スカラ,として指定します。ReadSizeプロパティをnに設定した場合(n > 1),関数が呼び出されるたびに関数は以下を読み取ります。

  • sdsにファ▪▪ルデ▪▪タが含まれている場合における,最初のnファ▪▪ルの最初の変数

  • sdsに@ @ンメモリデ@ @タが含まれている場合における,最初のn @ @メンバ@ @

の出力は,ReadSize> 1のとき,信号デ,タのcell配列となります。

オブジェクト関数

次の連続信号観測値の読み取り
readall デ,タストアのすべての信号の読み取り
预览 プレビュ,を目的としたデ,タストアの最初の信号観測値の読み取り
洗牌 信号デ,タストアの信号のシャッフル
子集 信号のサブセットをもデタストアの作成
分区 信号デ,タストアの分割,および分割した部分の返却
numpartitions 並列処理を目的とした妥当な区画数の推定の返却
重置 デ,タストアの初期状態へのリセット
进步 読み取ったデ,タ量の判定
hasdata デ,タが読み取り可能かどうかを判別
变换 デ,タストアの変換
结合 複数のデ,タストアのデ,タの結合
isPartitionable デ,タストアが分割可能かどうかを判別
isShuffleable デ,タストアがシャッフル可能かどうかを判別

メモ

isPartitionableおよびisShuffleableは,既定ではsignalDatastoreに対し真正的を返します。结合および变换の出力が分割可能またはシャッフル可能かどうかは,この2の関数を使用してテストできます。

すべて折りたたむ

信号デ,タストアを作成して,信号デ,タの,ンメモリcell配列の要素を反復します。デ,タは正弦波変調された線形チャ,プ,凹二次チャ,プ,および電圧制御発振器で構成されます。信号は,3000hzでサンプリングされます。

Fs = 3000;T = 0:1/fs:3-1/fs;data ={唧唧喳喳(300 t, t(结束),800年)。* exp (2 j *π* 10 * cos(2 *π* 2 * t));...2 *唧唧喳喳(1000 t, 200 t(结束),,“二次”[],“凹”);...vco(罪(2 *π* t) (0.1 - 0.4) * fs, fs)};sds =数据存储(数据,“SampleRate”fs);

データストアにデータがある場合は,信号データストアから各観測値を読み取り,短時間フーリエ変換をプロットします。

plotID = 1;hasdata(sds) [dataOut,info] = read(sds);subplot(3,1,plotID) stft(dataOut,info.SampleRate) plotID = plotID + 1;结束

信号处理工具箱™に含まれるサンプル信号へのパスを指定します。

文件夹= fullfile(matlabroot,“例子”“信号”“数据”);

指定したフォルダ,を示す信号デ,タストアを作成および表示します。

数据存储(文件夹)
文件:{'…/devel/bat/Bdoc20b/build/matlab/examples/signal/data/GANModel.mat';’……/猛击/棒/ Bdoc20b /构建/ matlab /例子/信号/数据/ HeartRates.mat”;“…/猛击/棒/ Bdoc20b /构建/ matlab / /信号/数据/ Hello示例。垫”……} AlternateFileSystemRoots: [0x0 string] ReadSize: 1

信号处理工具箱™に含まれる信号サンプルへのファイルパスを指定します。

文件夹= fullfile(matlabroot,“例子”“信号”“数据”);

指定したフォルダ,内の. csvファ▪▪ルを示す信号デ▪▪タストアを作成します。

sds = signalDatastore“FileExtensions”. csv”
Files:{'…/devel/bat/Bdoc20b/build/matlab/examples/signal/data/tremor.csv'} AlternateFileSystemRoots: [0x0 string] ReadSize: 1 .

信号处理工具箱™に含まれる4つのサンプルファイルへのパスを指定します。

文件夹= fullfile(matlabroot,“例子”“信号”“数据”...“INR.mat”“relatedsig.mat”“spots_num.mat”“voice.mat”]);

2 .;ReadSizeプロパティを2に設定します。各では,最初の细胞が最初に読み取ったファイルの最初の変数を含み,2番目の细胞が2番目のファイルの最初の変数を含む细胞配列が返されます。デ,タストアにデ,タがある場合,各で読み取った変数の名前を表示します。

sds = signalDatastore“ReadSize”2);Hasdata (sds) [data,info] = read(sds);流(变量名:\ t % s \ n”info.SignalVariableNames)结束
变量名称:日期变量名称:s1变量名称:年变量名称:fs

信号处理工具箱™に含まれる3つの信号へのパスを指定します。

  • strong.matファルには,她,およびfsという3の変数が格納されています。

  • slogan.matファ电子邮箱ルには,hotword短语およびfsという3の変数が格納されています。

  • Ring.matファesc esc esc esc esc esc esc esc esc esc esc esc年代という2の変数が格納されています。

FLD = [“strong.mat”“slogan.mat”“Ring.mat”];文件夹= fullfile(matlabroot,“例子”“信号”“数据”,盛名);

指定したフォルダ,を示す信号デ,タストアを作成します。各ファ电子邮箱ルには,名前の異なる複数の変数が格納されています。各ファイル内のスカラーは、サンプル レートを表します。カスタム読み取り関数を定義します。この関数は、ファイル内のすべての変数を構造体として読み取り、dataOut内の変数およびinfoOut内の変数の情報を返します。infoOutSampleRateフィルドには各ファルに含まれるスカラが含まれ,dataOutには各ファ@ @ルから読み取った変数が含まれます。

函数[dataOut,infoOut] = MyCustomRead(文件名)fText = importdata(文件名);value = struct2cell(fText);dataOut = {};I = 1:长度(值)如果isscalar(value{i}) == 1 infoOut. isscalar(value{i})SampleRate = value{i};其他的dataOut{end+1} = value{i};结束结束结束
sds = signalDatastore“ReadFcn”, @MyCustomRead);

データストアに読み取られていないファイルがある場合,データストアから読み取って,信号の短時間フーリエ変換を計算します。

hasdata(sds) [data,infoOut] = read(sds);fs = infoOut.SampleRate;数字I = 1:长度(data)如果长度(数据)> 1次要情节(2,1,我)结束stft(数据{我},fs)结束结束

信号处理工具箱™に含まれるサンプルファイルへのパスを指定します。各ファfsが含まれます。

  • 最初の信号x1は,振動する振幅の領域および増加傾向で変動する周波数の領域によって分離された,持続時間が減少していく一連のパルスで構成されています。

  • 2番目の信号x2は,正弦関数的に変化する周波数成分をもチャプです。

文件夹= fullfile(matlabroot,“例子”“信号”“数据”“数据集”);

指定したフォルダ,を示す信号デ,タストアを作成し,信号変数名とサンプルレ,トを設定します。デ,タストアにデ,タがある場合は,各観測値を読み取り,そのスペクトログラムを可視化します。

sds = signalDatastore“SignalVariableNames”,[x1的;“x2”],“SampleRateVariableName”“fs”);plotID = 1;Hasdata (sds) [data,info] = read(sds);次要情节(2,2,plotID) pspectrum(数据{1},信息。SampleRate,“OverlapPercent”, 50岁,“漏”, 1双侧的,真的,的谱图) subplot(2,2,plotID+1) pspectrum(数据{2},信息。SampleRate,“OverlapPercent”, 90,“漏”, 0.4,双侧的,真的,的谱图) plotID = plotID + 2;结束

R2020aで導入