slice

ボリューム データ スライス平面

• 

構文

slice(X,Y,Z,V,xslice,yslice,zslice)

slice(V,xslice,yslice,zslice)

slice(___,method)

slice(ax,___)

s = slice(___)

説明

slice(X,Y,Z,V,xslice,yslice,zslice) は、容積測定データ V のスライスを描画します。座標データとして X、Y、Z を指定します。次の形式のいずれかを使用して、スライスの位置として xslice、yslice、zslice を指定します。

• 特定の軸と直交する 1 つ以上のスライス平面を描画するには、スカラーまたはベクトルとしてスライス引数を指定します。

• 表面に沿って単一のスライスを描画するには、表面を定義する行列としてすべてのスライス引数を指定します。

slice(V,xslice,yslice,zslice) は V の既定の座標データを使用します。V 内の各要素の (x,y,z) 位置は、それぞれ列、行、ページ インデックスに基づきます。

slice(___,method) は内挿法を指定します。method は 'linear' (既定)、'cubic'、'nearest' のいずれかです。このオプションは、前述の構文における任意の入力引数と共に使用します。

slice(ax,___) は、現在の座標軸 (gca) ではなく指定された座標軸にプロットします。

s = slice(___) は、作成した Surface オブジェクトを返します。slice はスライスごとに 1 つの Surface オブジェクトを返します。

例

スライスに沿ったボリューム データ

各軸に直交するスライス平面に沿って容積測定データを表示します。

$$v=x{e}^{-x^2-y^2-z^2}$$ で定義されるボリュームからスライス平面を作成します。ここで x、y、z の範囲は [-2,2] です。値 -1.2、0.8、2 で x 軸に直交し、値 0 で z 軸に直交するスライス平面を作成します。空の配列を指定することにより、y 軸に直交するスライス平面は作成しません。

[X,Y,Z] = meshgrid(-2:.2:2);
V = X.*exp(-X.^2-Y.^2-Z.^2);

xslice = [-1.2,0.8,2];   
yslice = [];
zslice = 0;
slice(X,Y,Z,V,xslice,yslice,zslice)

表面に沿ったボリューム データ

容積測定データを非平面のスライスに沿って表示します。容積測定データを表示する表面を定義します。

ボリューム配列 V を、$$v=x{e}^{-x^2-y^2-z^2}$$ により定義されるボリュームとして作成します。ここで、x、y、z の範囲は [-5,5] です。次に、$z=x^2-y^2$ によって定義される表面に沿ってボリューム データのスライスを表示します。

[X,Y,Z] = meshgrid(-5:0.2:5);
V = X.*exp(-X.^2-Y.^2-Z.^2);

[xsurf,ysurf] = meshgrid(-2:0.2:2);
zsurf = xsurf.^2-ysurf.^2;
slice(X,Y,Z,V,xsurf,ysurf,zsurf)

内挿法の指定

容積測定データからスライス平面を作成します。データ値の内挿法を指定します。

値 0.8 で x 軸に直交するスライス平面を作成します。ボリューム データは x の値 0.8 に対して定義されていないため、関数 slice は近い値を内挿します。最も近いデータ点の値を使用するには、内挿法を 'nearest' に指定します。

[X,Y,Z] = meshgrid(-2:2);
V = X.*exp(-X.^2-Y.^2-Z.^2);
xslice = 0.8;   
yslice = [];
zslice = [];
slice(X,Y,Z,V,xslice,yslice,zslice,'nearest')

入力引数

X — x 軸座標のデータ

ベクトル | 3 次元配列

x 軸座標のデータ。ベクトルまたは V と同じサイズの 3 次元配列として指定します。3 次元配列を指定する場合、関数 meshgrid で生成されるものと同様に、単調かつ直交空間でなければなりません

データ型: single | double

Y — y 軸座標のデータ

ベクトル | 3 次元配列

y 軸座標のデータ。ベクトルまたは V と同じサイズの 3 次元配列として指定します。3 次元配列を指定する場合、関数 meshgrid で生成されるものと同様に、単調かつ直交空間でなければなりません

データ型: single | double

Z — z 軸座標のデータ

ベクトル | 3 次元配列

z 軸座標のデータ。ベクトルまたは V と同じサイズの 3 次元配列として指定します。3 次元配列を指定する場合、関数 meshgrid で生成されるものと同様に、単調かつ直交空間でなければなりません

データ型: single | double

V — ボリューム データ

3 次元配列

ボリューム データ。3 次元配列として指定します。

データ型: single | double

xslice — x 軸のスライス値

スカラー | ベクトル | [] | 行列

x 軸のスライス値。次のいずれかの形式で指定します。

• スカラー — 指定された位置で x 軸に直交するスライス平面を 1 つ描画します。

• ベクトル — 指定された位置で x 軸に直交するスライス平面を複数描画します。

• [] — スライス平面は描画しません。

• 行列 — 平面の代わりに表面に沿ったスライスを描画します。このオプションを使用する場合、yslice と zslice も同じサイズの行列でなければなりません。

例: [2 4] は値 2 と 4 で x 軸に直交するスライス平面を描画します。

データ型: single | double

yslice — y 軸のスライス値

スカラー | ベクトル | [] | 行列

y 軸のスライス値。次のいずれかの形式で指定します。

• スカラー — 指定された位置で y 軸に直交するスライス平面を 1 つ描画します。

• ベクトル — 指定された位置で y 軸に直交するスライス平面を複数描画します。

• [] — スライス平面は描画しません。

• 行列 — 平面の代わりに表面に沿ったスライスを描画します。このオプションを使用する場合、xslice と zslice も同じサイズの行列でなければなりません。

例: [2 4] は値 2 と 4 で y 軸に直交するスライス平面を描画します。

データ型: single | double

zslice — z 軸のスライス値

スカラー | ベクトル | [] | 行列

z 軸のスライス値。次のいずれかの形式で指定します。

• スカラー — 指定された位置で z 軸に直交するスライス平面を 1 つ描画します。

• ベクトル — 指定された位置で z 軸に直交するスライス平面を複数描画します。

• [] — スライス平面は描画しません。

• 行列 — 平面の代わりに表面に沿ったスライスを描画します。このオプションを使用する場合、xslice と yslice も同じサイズの行列でなければなりません。

例: [2 4] は値 2 と 4 で z 軸に直交するスライス平面を描画します。

データ型: single | double

method — 内挿法

'linear' (既定値) | 'cubic' | 'nearest'

内挿法。次の値のいずれかとして指定します。

• 'linear' — 対応する各次元における、隣接するグリッド点の値の線形内挿

• 'cubic' — 対応する各次元における、隣接するグリッド点の値の 3 次内挿

• 'nearest' — 最も近いグリッド点の値

ax — ターゲット座標軸

現在の座標軸 (既定値) | Axes オブジェクト

ターゲット座標軸。Axes オブジェクトとして指定します。座標軸を指定しない場合、slice は現在の座標軸にプロットします。

拡張機能

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

slice 関数は GPU 配列入力をサポートしますが、次の使用上の注意および制限があります。

• この関数は GPU 配列を受け入れますが、GPU 上では実行されません。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

使用上の注意および制限:

• この関数は分散配列に対して演算を行いますが、クライアントの MATLAB^® で実行されます。

詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a より前に導入

参考

meshgrid | contourslice | isosurface | interp3 | obliqueslice (Image Processing Toolbox)