このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

clim

カラーマップの範囲を設定 (R2022a で caxis から名前変更)

構文

clim(limits)

clim("auto")

clim("manual")

clim(target,___)

lims = clim

説明

clim(limits) は現在の座標軸のカラーマップの範囲を設定します。limits は [cmin cmax] の形式の 2 要素ベクトルです。カラーマップ インデックス配列の cmin 以下の値はすべて、カラーマップの最初の行にマッピングされます。cmax 以上の値はすべて、カラーマップの最後の行にマッピングされます。cmin と cmax の間の値はすべて、カラーマップの中間の行に線形にマッピングされます。

メモ

関数 clim は、CDataMapping プロパティが "scaled" に設定されたグラフィックス オブジェクトのみに影響します。トゥルーカラーを使用するグラフィックス オブジェクト、または CDataMapping が "direct" に設定されたグラフィックス オブジェクトには影響しません。

clim("auto") は、カラーマップ インデックス配列内の値が変更されたときの自動範囲更新を有効にします。これは既定の動作です。clim auto コマンドはこの構文の代替形式です。

clim("manual") は自動範囲更新を無効にします。clim manual コマンドはこの構文の代替形式です。

clim(target,___) は特定の座標軸またはスタンドアロンの可視化のカラーマップの範囲を設定します。前述の任意の構文で最初の入力引数として target を指定します。

lims = clim は、[cmin cmax] の形式のベクトルとして現在のカラーマップの範囲を返します。

例

下限を上げる

放物面とカラー バーをプロットします。

[X,Y] = meshgrid(-5:.5:5);
Z = X.^2 + Y.^2;
surf(Z);
colorbar

現在の色の範囲を取得します。

lims = clim

lims = 1×2

     0    50

下限を 20 に上げます。20 以下の Z 値はすべて、最初の色にマッピングされることがわかります。

clim([20 50])

複数の表面プロットの色の範囲を保持

垂直方向にオフセットされる 2 つの放物面を作成します。

[X,Y] = meshgrid(-5:.5:5);
Z1 = X.^2 + Y.^2;
Z2 = Z1 + 50;

最初の放物面をプロットします。カラー バーを追加し、2 番目の放物面の座標軸を保持します。

surf(X,Y,Z1);
colorbar
hold on

"manual" オプションを使用して現在の色の範囲を保持します。次に 2 番目の放物面をプロットします。

clim("manual");
surf(X,Y,Z2);

特定の座標軸に色の範囲を設定

関数 tiledlayout を呼び出して、1 行 2 列のタイル表示チャート レイアウトを作成します。関数 nexttile を呼び出して、axes オブジェクト ax1 および ax2 を作成します。各座標軸に放物面をプロットします。

[X,Y] = meshgrid(-5:1:5);
Z = X.^2 + Y.^2;
tiledlayout(1,2)

% Left plot
ax1 = nexttile;
surf(ax1,Z);

% Right plot
ax2 = nexttile;
surf(ax2,Z);

右側の座標軸の色の下限を 20 に上げます。

clim(ax2,[20 50])

入力引数

limits — 新しい範囲

[cmin cmax] の形式のベクトル

新しい範囲。[cmin cmax] の形式のベクトルとして指定します。cmin の値は、cmax 未満でなければなりません。

データ型: single | double

target — ターゲット オブジェクト

現在の座標軸 (既定値) | Axes オブジェクト | PolarAxes オブジェクト | GeographicAxes オブジェクト | スタンドアロンの可視化

ターゲット オブジェクト。Axes オブジェクト、PolarAxes オブジェクト、GeographicAxes オブジェクトとして、または Colormap プロパティをもつスタンドアロンの可視化として指定します。

詳細

カラーマップ インデックス配列

チャートのデータ要素をカラーマップの特定の行にマッピングする配列。MATLAB^® はインデックス配列をグラフィックス オブジェクトのプロパティとして保存します。

たとえば、Surface オブジェクトの CData プロパティは、表面上のグリッド点をカラーマップの特定の行にマッピングするインデックス配列です。

バージョン履歴

R2006a より前に導入

R2022a: caxis から名前変更

関数名を CLim 座標軸プロパティに合ったものにするために、caxis は clim という名前に変更されました。

参考

colormap | colorbar

トピック

• カラーマップの範囲の制御