最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

export

クラス: Simulink.sdi.Signal
パッケージ: Simulink.sdi

MATLAB timeseries への信号オブジェクトのエクスポート

構文

ts = sigObj.export
ts = sigObj.export(startTime, endTime)
sigObj.export(___,Name,Value)

説明

ts = sigObj.export は、Simulink.sdi.Signal オブジェクト sigObj を MATLAB® ワークスペース内の timeseries ts にエクスポートします。

ts = sigObj.export(startTime, endTime) は、startTime および endTime で定義された Simulink.sdi.Signal オブジェクトの一部を MATLAB ワークスペース内の timeseries ts にエクスポートします。

sigObj.export(___,Name,Value)Simulink.sdi.Signal オブジェクトを、1 つ以上の名前と値のペアの引数により指定されるオプションに従って、ベース ワークスペースまたはファイルにエクスポートします。

入力引数

すべて展開する

エクスポートする信号部分の開始時間。

例: 0

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

エクスポートする信号部分の終了時間。

例: 10

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

名前と値のペアの引数

オプションのコンマ区切りされた Name,Value の引数ペアを指定します。ここで、Name は引数名、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペア引数を任意の順序で指定できます。

例: 'to','file'

データをベース ワークスペース内の変数にエクスポートするか、ファイルにエクスポートするかを指定します。

データをファイルにエクスポートする場合、名前と値のペアの引数 'filename' を使用してファイル名も指定しなければなりません。MAT または XLSX 拡張子をもつファイル名を指定できます。

信号を MAT ファイルにエクスポートする場合、データは timeseries オブジェクトとして MAT ファイルに保存されます。

Microsoft® Excel® ファイルにエクスポートされたデータは、シミュレーション データ インスペクターのインポートおよびエクスポート ファイル形式で説明した形式を使用して保存されます。

データを Microsoft Excel ファイルにエクスポートする場合、名前と値のペア 'overwrite''metadata'、および 'sharetimecolumn' を使用して追加オプションを指定できます。

例: 'to','file'

エクスポートされたデータを含めるファイルの名前。string または文字配列として指定します。MAT または XLSX 拡張子をファイル名に含めることで、MAT ファイルにエクスポートするか、Microsoft Excel ファイルにエクスポートするかを指定します。ファイル名に拡張子を指定しない場合、データは MAT ファイルにエクスポートされます。

名前と値のペアの引数 'to' を値 'file' で指定した場合は、名前と値のペアの引数 'filename' を使用します。

データを Microsoft Excel ファイルにエクスポートする場合、名前と値のペアの引数 'overwrite''metadata'、および 'sharetimecolumn' を使用して追加オプションを指定できます。

例: 'filename',"mySpreadsheet.xlsx"

既存のファイル内で上書きするデータを指定します。データを既に存在する Microsoft Excel ファイルにエクスポートするときに、エクスポートによってファイル全体を上書きするか、ファイル内の影響を受けたシートのみを上書きするかを制御できます。

  • 'file' — エクスポートされたデータでファイル全体を上書きする。

  • 'sheetsonly' — エクスポートされたデータに対応するデータをもつ Microsoft Excel ファイルのシートのみを上書きする。

例: 'overwrite','sheetsonly'

エクスポートされた Microsoft Excel ファイルに含めるメタデータ。string 配列で指定します。既定では、エクスポート操作にはメタデータは含まれません。次のメタデータを Microsoft Excel ファイルにエクスポートできます。

  • dataType — 信号のデータ型

  • units — 信号の単位

  • blockPath — ログに記録された信号のソース ブロックへのパス

  • interp — 信号の内挿法

  • portIndex — ログ記録された信号のソース ブロックの端子のインデックス

必要なメタデータを string 配列で選択した任意の順序で指定できます。メタデータの順序はエクスポートされたファイルでの形式に影響しません。エクスポートされたファイルでの形式は常にシミュレーション データ インスペクターのインポートおよびエクスポート ファイル形式での説明に一致します。

例: 'metadata',["units","dataType"]

同一の時間データをもつ信号について、エクスポートされたファイルで時間列を共有するかどうかを指定します。既定では、同じ時間データをもつ信号はエクスポートされたファイルで時間列を共有します。この値を 'off' に指定すると、エクスポートされたファイル内の各信号は独自の時間列をもちます。

例: 'sharetimecolumn','off'

出力引数

すべて展開する

Simulink.sdi.Signal オブジェクトからエクスポートされる timeseries。

すべて展開する

この例では、信号を生成し、信号データを timeseries にエクスポートする方法を示します。

% Simulate model sldemo_fuelsys to create a run of logged signals
sim('sldemo_fuelsys');
 
% Get the runID
runIDs = Simulink.sdi.getAllRunIDs;
runID = runIDs(end);

% Get the run object
fuelRun = Simulink.sdi.getRun(runID);

% Get a signal
signal = fuelRun.getSignalByIndex(2);
 
% Export signal data to timeseries
ts = signal.export;

代替方法

シミュレーション データ インスペクター UI から MATLAB または MAT ファイルにデータをエクスポートできます。詳細については、シミュレーション データ インスペクターのデータと表示の保存および共有を参照してください。

R2017b で導入