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

plot3

3 次元の点またはライン プロット

構文

plot3(X,Y,Z)

plot3(X,Y,Z,LineSpec)

plot3(X1,Y1,Z1,...,Xn,Yn,Zn)

plot3(X1,Y1,Z1,LineSpec1,...,Xn,Yn,Zn,LineSpecn)

plot3(___,Name,Value)

plot3(ax,___)

p = plot3(___)

説明

plot3(X,Y,Z) は 3 次元空間に座標をプロットします。

• 線分によって接続された座標セットをプロットするには、X、Y、および Z を同じ長さのベクトルとして指定します。

• 同じ座標軸セットに複数の座標セットをプロットするには、X、Y、または Z のうちの少なくとも 1 つを行列として指定し、その他をベクトルとして指定します。

plot3(X,Y,Z,LineSpec) は、指定されたライン スタイル、マーカー、および色を使用してプロットを作成します。

plot3(X1,Y1,Z1,...,Xn,Yn,Zn) は、同じ座標軸セットに複数の座標セットをプロットします。複数のセットを行列として指定する代わりに、この構文を使用します。

plot3(X1,Y1,Z1,LineSpec1,...,Xn,Yn,Zn,LineSpecn) は、特定のライン スタイル、マーカー、および色を各 XYZ 3 成分に割り当てます。LineSpec を一部の 3 成分に対して指定し、その他に対しては省略することができます。たとえば、plot3(X1,Y1,Z1,'o',X2,Y2,Z2) は、最初の 3 成分に対してマーカーを指定しますが、2 番目の 3 成分に対しては指定しません。

plot3(___,Name,Value) は、1 つ以上の名前と値のペアの引数を使用して、Line プロパティを指定します。プロパティは他のすべての入力引数の後に指定します。プロパティの一覧については、Line のプロパティ を参照してください。

plot3(ax,___) は、ターゲット座標軸にプロットを表示します。前述の任意の構文で、最初の引数として座標軸を指定します。

p = plot3(___) は Line オブジェクトまたは Line オブジェクトの配列を返します。プロットのプロパティを作成後に変更するには、p を使用します。プロパティの一覧については、Line のプロパティ を参照してください。

例

3 次元らせんのプロット

0 ～ 10$\pi$ の間の値からなるベクトルとして t を定義します。st および ct を正弦値および余弦値のベクトルとして定義します。次に、st、ct、および t をプロットします。

t = 0:pi/50:10*pi;
st = sin(t);
ct = cos(t);
plot3(st,ct,t)

複数のラインのプロット

x、y、および z 座標を 2 セット作成します。

t = 0:pi/500:pi;
xt1 = sin(t).*cos(10*t);
yt1 = sin(t).*sin(10*t);
zt1 = cos(t);

xt2 = sin(t).*cos(12*t);
yt2 = sin(t).*sin(12*t);
zt2 = cos(t);

関数 plot3 を呼び出して、連続する XYZ 3 成分を指定します。

plot3(xt1,yt1,zt1,xt2,yt2,zt2)

行列を使用した複数のラインのプロット

x 座標の 3 行を含む行列 X を作成します。y 座標の 3 行を含む行列 Y を作成します。

t = 0:pi/500:pi;
X(1,:) = sin(t).*cos(10*t);
X(2,:) = sin(t).*cos(12*t);
X(3,:) = sin(t).*cos(20*t);

Y(1,:) = sin(t).*sin(10*t);
Y(2,:) = sin(t).*sin(12*t);
Y(3,:) = sin(t).*sin(20*t);

3 セットすべての z 座標を含む行列 Z を作成します。

Z = cos(t);

3 つすべての座標セットを同じ座標軸セットにプロットします。

plot3(X,Y,Z)

等間隔の目盛り単位と軸ラベルの指定

ベクトル xt、yt、および zt を作成します。

t = 0:pi/500:40*pi;
xt = (3 + cos(sqrt(32)*t)).*cos(t);
yt = sin(sqrt(32) * t);
zt = (3 + cos(sqrt(32)*t)).*sin(t);

データをプロットし、axis equal コマンドを使用して各軸に沿って目盛り単位が等間隔になるように調整します。各軸のラベルを指定します。

plot3(xt,yt,zt)
axis equal
xlabel('x(t)')
ylabel('y(t)')
zlabel('z(t)')

ラインのないマーカーとして点をプロット

ベクトル t、xt、および yt を作成し、円マーカーを使用してこれらのベクトルに点をプロットします。

t = 0:pi/20:10*pi;
xt = sin(t);
yt = cos(t);
plot3(xt,yt,t,'o')

色とマーカーのカスタマイズ

ベクトル t、xt、および yt を作成し、10 ポイントの円マーカーを使用して、これらのベクトルに青線で点をプロットします。16 進数カラー コードを使用して、薄い青の塗りつぶし色をマーカーに指定します。

t = 0:pi/20:10*pi;
xt = sin(t);
yt = cos(t);
plot3(xt,yt,t,'-o','Color','b','MarkerSize',10,'MarkerFaceColor','#D9FFFF')

ライン スタイルの指定

ベクトル t を作成します。次に、t を使用して、2 組の x および y 値を計算します。

t = 0:pi/20:10*pi;
xt1 = sin(t);
yt1 = cos(t);

xt2 = sin(2*t);
yt2 = cos(2*t);

2 組の値をプロットします。最初の組に対しては既定のラインを使用し、2 組目に対しては破線を指定します。

plot3(xt1,yt1,t,xt2,yt2,t,'--')

プロット後のラインの変更

ベクトル t、xt、および yt を作成し、これらのベクトルにデータをプロットします。出力変数 p でチャート ラインを返します。

t = linspace(-10,10,1000);
xt = exp(-t./10).*sin(5*t);
yt = exp(-t./10).*cos(5*t);
p = plot3(xt,yt,t);

ライン幅を 3 に変更します。

p.LineWidth = 3;

ターゲット座標軸の指定

R2019b 以降、関数 tiledlayout および nexttile を使用して、プロットをタイル表示できます。関数 tiledlayout を呼び出して、1 行 2 列のタイル表示チャート レイアウトを作成します。関数 nexttile を呼び出して、axes オブジェクト ax1 および ax2 を作成します。axes オブジェクトを plot3 に対する最初の引数として指定することで、座標軸に個別のライン プロットを作成します。

tiledlayout(1,2)

% Left plot
ax1 = nexttile;
t = 0:pi/20:10*pi;
xt1 = sin(t);
yt1 = cos(t);
plot3(ax1,xt1,yt1,t)
title(ax1,'Helix With 5 Turns')

% Right plot
ax2 = nexttile;
t = 0:pi/20:10*pi;
xt2 = sin(2*t);
yt2 = cos(2*t);
plot3(ax2,xt2,yt2,t)
title(ax2,'Helix With 10 Turns')

カスタム目盛り形式を使用した duration データのプロット

0 ～ 1 の乱数値のベクトルとして x と y を作成します。乱数の duration 値のベクトルとして z を作成します。

x = rand(1,10);
y = rand(1,10);
z = duration(rand(10,1),randi(60,10,1),randi(60,10,1));

x、y、および z をプロットし、z 軸の形式を分と秒で指定します。次に、軸ラベルを追加し、グリッドをオンにして、プロット ボックス内での点の可視化を容易にします。

plot3(x,y,z,'o','DurationTickFormat','mm:ss')
xlabel('X')
ylabel('Y')
zlabel('Duration')
grid on

1 つのデータ点でのマーカー付きラインのプロット

ベクトル xt、yt、および zt を作成します。値をプロットし、LineSpec 引数を使用して円マーカーで実線を指定します。200 番目のデータ点に 1 つのマーカーを配置するには、MarkerIndices プロパティを指定します。

t = 0:pi/500:pi;
xt(1,:) = sin(t).*cos(10*t);
yt(1,:) = sin(t).*sin(10*t);
zt = cos(t);
plot3(xt,yt,zt,'-o','MarkerIndices',200)

入力引数

X — x 座標

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

x 座標。スカラー、ベクトルまたは行列として指定します。X のサイズと形状は、データの形状と作成するプロットのタイプによって異なります。次の表では、最も一般的な状況について説明します。

プロットのタイプ	座標の指定方法
1 つの点	X、Y、および Z をスカラーとして指定して、マーカーを含めます。以下に例を示します。 plot3(1,2,3,'o')
1 つの点集合	X、Y、および Z を同じ長さの行ベクトルまたは列ベクトルの任意の組み合わせとして指定します。以下に例を示します。 plot3([1 2 3],[4; 5; 6],[7 8 9])
複数の点集合 (ベクトルを使用)	連続した X、Y、および Z ベクトルのセットを指定します。以下に例を示します。 plot3([1 2 3],[4 5 6],[7 8 9],[1 2 3],[4 5 6],[10 11 12])
複数の点集合 (行列を使用)	X、Y、または Z のうちの少なくとも 1 つを行列として指定し、その他をベクトルとして指定します。X、Y、および Z のそれぞれに、サイズが同じ次元が少なくとも 1 つなければなりません。最適な結果を得るには、同じ形状のすべてのベクトルと同じ形状のすべての行列を指定します。以下に例を示します。 plot3([1 2 3],[4 5 6],[7 8 9; 10 11 12])

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

Y — y 座標

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

y 座標。スカラー、ベクトルまたは行列として指定します。Y のサイズと形状は、データの形状と作成するプロットのタイプによって異なります。次の表では、最も一般的な状況について説明します。

プロットのタイプ	座標の指定方法
1 つの点	X、Y、および Z をスカラーとして指定して、マーカーを含めます。以下に例を示します。 plot3(1,2,3,'o')
1 つの点集合	X、Y、および Z を同じ長さの行ベクトルまたは列ベクトルの任意の組み合わせとして指定します。以下に例を示します。 plot3([1 2 3],[4; 5; 6],[7 8 9])
複数の点集合 (ベクトルを使用)	連続した X、Y、および Z ベクトルのセットを指定します。以下に例を示します。 plot3([1 2 3],[4 5 6],[7 8 9],[1 2 3],[4 5 6],[10 11 12])
複数の点集合 (行列を使用)	X、Y、または Z のうちの少なくとも 1 つを行列として指定し、その他をベクトルとして指定します。X、Y、および Z のそれぞれに、サイズが同じ次元が少なくとも 1 つなければなりません。最適な結果を得るには、同じ形状のすべてのベクトルと同じ形状のすべての行列を指定します。以下に例を示します。 plot3([1 2 3],[4 5 6],[7 8 9; 10 11 12])

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

Z — z 座標

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

z 座標。スカラー、ベクトルまたは行列として指定します。Z のサイズと形状は、データの形状と作成するプロットのタイプによって異なります。次の表では、最も一般的な状況について説明します。

プロットのタイプ	座標の指定方法
1 つの点	X、Y、および Z をスカラーとして指定して、マーカーを含めます。以下に例を示します。 plot3(1,2,3,'o')
1 つの点集合	X、Y、および Z を同じ長さの行ベクトルまたは列ベクトルの任意の組み合わせとして指定します。以下に例を示します。 plot3([1 2 3],[4; 5; 6],[7 8 9])
複数の点集合 (ベクトルを使用)	連続した X、Y、および Z ベクトルのセットを指定します。以下に例を示します。 plot3([1 2 3],[4 5 6],[7 8 9],[1 2 3],[4 5 6],[10 11 12])
複数の点集合 (行列を使用)	X、Y、または Z のうちの少なくとも 1 つを行列として指定し、その他をベクトルとして指定します。X、Y、および Z のそれぞれに、サイズが同じ次元が少なくとも 1 つなければなりません。最適な結果を得るには、同じ形状のすべてのベクトルと同じ形状のすべての行列を指定します。以下に例を示します。 plot3([1 2 3],[4 5 6],[7 8 9; 10 11 12])

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

LineSpec — ライン スタイル、マーカー、色

文字ベクトル | string

ライン スタイル、マーカーおよび色。記号を含む文字ベクトルまたは string として指定します。記号の順番は任意です。3 つの特性 (ライン スタイル、マーカーおよび色) をすべて指定する必要はありません。たとえば、ライン スタイルを省略してマーカーを指定する場合、プロットはラインなしでマーカーのみを表示します。

例: '--or' は丸いマーカーをもった赤い破線

ライン スタイル	説明
-	実線 (既定の設定)
--	破線
:	点線
-.	一点鎖線

マーカー	説明
o	円
+	プラス記号
*	アスタリスク
.	点
x	十字
s	正方形
d	菱形
^	上向き三角形
v	下向き三角形
>	右向き三角形
<	左向き三角形
p	星形五角形
h	星形六角形

色	説明
y	黄
m	マゼンタ
c	シアン
r	赤
g	緑
b	青
w	白
k	黒

ax — ターゲット座標軸

Axes オブジェクト

ターゲット座標軸。Axes オブジェクトとして指定します。座標軸を指定せず、現在の座標軸が直交座標軸の場合、関数 plot は現在の座標軸を使用します。

名前と値のペアの引数

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

例: plot3([1 2],[3 4],[5 6],'Color','red') はプロットに赤のラインを指定します。

メモ

ここでは、プロパティの一部だけを紹介しています。完全な一覧については、Line のプロパティ を参照してください。

'Color' — 色

[0 0.4470 0.7410] (既定値) | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。指定した色がラインの色に設定されます。MarkerEdgeColor プロパティが 'auto' に設定されている場合は、マーカー エッジの色も設定されます。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

• RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

• 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード '#FF8800'、'#ff8800'、'#F80'、および '#f80' は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

色名	省略名	RGB 3 成分	16 進数カラー コード	外観
'red'	'r'	[1 0 0]	'#FF0000'
'green'	'g'	[0 1 0]	'#00FF00'
'blue'	'b'	[0 0 1]	'#0000FF'
'cyan'	'c'	[0 1 1]	'#00FFFF'
'magenta'	'm'	[1 0 1]	'#FF00FF'
'yellow'	'y'	[1 1 0]	'#FFFF00'
'black'	'k'	[0 0 0]	'#000000'
'white'	'w'	[1 1 1]	'#FFFFFF'
'none'	該当なし	該当なし	該当なし	色なし

MATLAB^® の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分	16 進数カラー コード	外観
[0 0.4470 0.7410]	'#0072BD'
[0.8500 0.3250 0.0980]	'#D95319'
[0.9290 0.6940 0.1250]	'#EDB120'
[0.4940 0.1840 0.5560]	'#7E2F8E'
[0.4660 0.6740 0.1880]	'#77AC30'
[0.3010 0.7450 0.9330]	'#4DBEEE'
[0.6350 0.0780 0.1840]	'#A2142F'

'LineWidth' — ライン幅

0.5 (既定値) | 正の値

ライン幅。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。ラインがマーカーをもつ場合、ライン幅はマーカー エッジにも影響します。

'MarkerSize' — マーカー サイズ

6 (既定値) | 正の値

マーカー サイズ。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。

'MarkerEdgeColor' — マーカーの輪郭の色

'auto' (既定値) | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

マーカーの輪郭の色。'auto'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。既定値の 'auto' は、Color プロパティと同じ色を使用します。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

• RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

• 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード '#FF8800'、'#ff8800'、'#F80'、および '#f80' は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

色名	省略名	RGB 3 成分	16 進数カラー コード	外観
'red'	'r'	[1 0 0]	'#FF0000'
'green'	'g'	[0 1 0]	'#00FF00'
'blue'	'b'	[0 0 1]	'#0000FF'
'cyan'	'c'	[0 1 1]	'#00FFFF'
'magenta'	'm'	[1 0 1]	'#FF00FF'
'yellow'	'y'	[1 1 0]	'#FFFF00'
'black'	'k'	[0 0 0]	'#000000'
'white'	'w'	[1 1 1]	'#FFFFFF'
'none'	該当なし	該当なし	該当なし	色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分	16 進数カラー コード	外観
[0 0.4470 0.7410]	'#0072BD'
[0.8500 0.3250 0.0980]	'#D95319'
[0.9290 0.6940 0.1250]	'#EDB120'
[0.4940 0.1840 0.5560]	'#7E2F8E'
[0.4660 0.6740 0.1880]	'#77AC30'
[0.3010 0.7450 0.9330]	'#4DBEEE'
[0.6350 0.0780 0.1840]	'#A2142F'

'MarkerFaceColor' — マーカーの塗りつぶし色

'none' (既定値) | 'auto' | RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

マーカーの塗りつぶし色。'auto'、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。'auto' オプションは親の座標軸の Color プロパティと同じ色を使用します。'auto' を指定し、座標軸のプロット ボックスが非表示の場合、マーカーの塗りつぶし色は figure の色です。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

• RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

• 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード '#FF8800'、'#ff8800'、'#F80'、および '#f80' は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

色名	省略名	RGB 3 成分	16 進数カラー コード	外観
'red'	'r'	[1 0 0]	'#FF0000'
'green'	'g'	[0 1 0]	'#00FF00'
'blue'	'b'	[0 0 1]	'#0000FF'
'cyan'	'c'	[0 1 1]	'#00FFFF'
'magenta'	'm'	[1 0 1]	'#FF00FF'
'yellow'	'y'	[1 1 0]	'#FFFF00'
'black'	'k'	[0 0 0]	'#000000'
'white'	'w'	[1 1 1]	'#FFFFFF'
'none'	該当なし	該当なし	該当なし	色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分	16 進数カラー コード	外観
[0 0.4470 0.7410]	'#0072BD'
[0.8500 0.3250 0.0980]	'#D95319'
[0.9290 0.6940 0.1250]	'#EDB120'
[0.4940 0.1840 0.5560]	'#7E2F8E'
[0.4660 0.6740 0.1880]	'#77AC30'
[0.3010 0.7450 0.9330]	'#4DBEEE'
[0.6350 0.0780 0.1840]	'#A2142F'

ヒント

• ラインの途中で間を空けるには NaN または Inf を使用します。たとえば、このコードは z=2 と z=4 の途中で間を空けてラインをプロットします。

   plot3([1 2 3 4 5],[1 2 3 4 5],[1 2 NaN 4 5])

• plot3 は座標軸の ColorOrder プロパティと LineStyleOrder プロパティに基づく色とライン スタイルを使用します。plot3 は最初のライン スタイルで色を順番に使用します。次に、以降のライン スタイルのそれぞれについて再び色を順番に使用します。

  R2019b 以降、座標軸の ColorOrder プロパティや LineStyleOrder プロパティを設定することによって、プロット後に色やライン スタイルを変更できます。また、関数 colororder を呼び出して、Figure 内のすべての座標軸の色の順序を変更することもできます。

拡張機能

GPU 配列

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

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

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

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

分散配列

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

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

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

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

参考

関数

• axis | bar3 | grid | nexttile | scatter3 | tiledlayout

プロパティ

• Line のプロパティ

トピック

• 日付と期間のプロット
• categorical データのプロット

R2006a より前に導入

×

例を開く

この例の変更されたバージョンがシステム上にあります。代わりにこのバージョンを開きますか?

いいえ、変更されたバージョンを上書きします。 はい