Main Content

prepareSurfaceData

データ入力を曲面近似用に準備する

説明

[XOut, YOut, ZOut] = prepareSurfaceData(XIn, YIn, ZIn) は、関数 fit での曲面近似用に、必要に応じてデータを変換します。関数は次のようにデータを変換します。

  • グリッド ベクトルの場合、行 (YIn) と列 (XIn) のヘッダーは、ZIn と同じサイズの配列 YOutXOut に変換されます。XInYIn が逆の場合は警告されます。

  • 入力形状に関係なく、データを列として返します。要素数が一致しない場合エラーになります。要素数が一致しても、サイズが異なると、警告されます。

  • 複素数から実数へ変換し (虚数部を除去)、この変換について警告します。

  • データから NaN または Inf を削除し、この削除について警告します。

  • double 以外から double に変換し、この変換について警告します。

[XOut, YOut, ZOut, WOut] = prepareSurfaceData(XIn, YIn, ZIn, WIn) は、関数 fit での曲面近似用に重み (WIn) を含むデータを変換します。

データが列ベクトル形式でない場合は、prepareSurfaceData を使用します。たとえば、3 つの行列があるとします。グリッド ベクトルがある場合は prepareSurfaceData も使用できます。ここで、length(XIn) = n, length(YIn) = m および size(ZIn) = [m,n] です。関数 fit で使用するために、prepareSurfaceData を使用してグリッド ベクトル データを処理しなければなりません。曲線フィッター アプリを使用している場合は、グリッド ベクトル データを選択すると、データは自動的に変換されます。

データが MATLAB® table にある場合は、prepareSurfaceData を使用する必要はありません。形式 tablename.varname を使用して、MATLAB table 内の変数を関数 fit への入力として指定できます。

曲線フィッター アプリからコードを生成すると、生成されたコードには、prepareSurfaceData (または曲線近似の場合は prepareCurveData) への呼び出しが含まれます。近似とプロットを再作成するには、コマンド ラインから元のデータまたは新しいデータを入力引数に指定して生成されたファイルを呼び出します。生成されたファイルを新しいデータで呼び出すと、関数 prepareCurveData は、どのようなデータでも曲線フィッター アプリでの近似に使用できるようにするため、必要に応じてデータを変形し、NaNInf、または複素数の虚数部を削除します。

すべて折りたたむ

double でも列でもなく、Nan 値と Inf 値がいくつか含まれる、前処理なしでは関数 fit に適していないデータを作成します。

x = int32(1:4);
y = int32(1:5);
z = rand(5,4);
z(13) = Inf;
z(3) = NaN; 

prepareSurfaceData を使用して、行を列に、double 以外から double に変換し、NanInf を除外します。

[xo,yo,zo] = prepareSurfaceData(x,y,z); 

関数は、曲線フィッター アプリでこのデータを選択した場合に表示されるものと同じ警告を表示します。警告は、関数 fit に適合させるためのデータの処理方法を通知します。

whos を使用して、prepareSurfaceData が変数を double の列ベクトルに変換したことを確認します。

whos xo yo zo 

入力引数

すべて折りたたむ

曲面近似に対して準備する X データ変数。スカラー、ベクトル、または行列として指定します。

データ型: double

曲面近似に対して準備する Y データ変数。スカラー、ベクトル、または行列として指定します。

データ型: double

曲面近似に対して準備する Z データ変数。スカラー、ベクトル、または行列として指定します。

データ型: double

曲面近似に対して準備する重み変数。スカラー、ベクトル、または行列として指定します。

データ型: double

出力引数

すべて折りたたむ

曲面近似用に準備された X データ列変数。ベクトルとして返されます。

データ型: double

曲面近似用に準備された Y データ列変数。ベクトルとして返されます。

データ型: double

曲面近似用に準備された Z データ列変数。ベクトルとして返されます。

データ型: double

曲面近似用に準備された重み列変数。ベクトルとして返されます。

データ型: double

バージョン履歴

R2010b で導入