ドキュメンテーション

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

caxis

色軸のスケーリング

構文

caxis([cmin cmax])
caxis auto
caxis manual
caxis(caxis)
v = caxis
caxis(axes_handle,...)

説明

caxis は、データ値からカラーマップへのマッピングを制御します。これは、インデックス付きの CData をもっており、CDataMapping が scaled に設定されている surfacepatchimage に影響を与えます。しかし、トゥルーカラーの CData をもっているか、CDataMappingdirect に設定されている surface、patche、あるいは image には影響を与えません。

caxis([cmin cmax]) は、色の範囲を指定された最小値と最大値に設定します。cmin より小さいか cmax より大きいデータ値は、それぞれ cmincmax にマッピングされます。cmincmax の間の値は、現在のカラーマップに線形にマッピングされます。

caxis auto では、データの最小値と最大値を使用して、色の範囲を自動的に計算します。これは既定の動作です。Inf に設定された色値は最大の色、-Inf に設定された色値は最小の色にマッピングされます。NaN に設定された色値をもつ面やエッジは描画されません。

caxis manualcaxis(caxis) は、現在の範囲に色軸のスケーリングを固定します。これにより、holdon の場合、後に続くプロットは同じ範囲を使用できます。

v = caxis は、現在使用されている [cmin cmax] を含む 2 要素の行ベクトルを返します。

caxis(axes_handle,...) は、現在の軸に代えて axes_handle で指定される軸を使用します。

caxis は、座標軸のグラフィックス オブジェクトの CLim および CLimMode プロパティを変更します。

すべて折りたたむ

色軸のスケーリングの変更

XY および Z を球のデータとして定義し、このデータを表面として表示します。表面 C の色を定義します。

[X,Y,Z] = sphere;
C = Z;
surf(X,Y,Z,C)

C の値は、[-1,1] の範囲にあります。-1 に近い C の値には、カラーマップの最も低い値が割り当てられます。1 に近い C の値には、カラーマップの最も高い値が割り当てられます。

球の上半分をカラー テーブルの最も高い値にマッピングするには、色の最大値を 0 に設定します。

caxis([-1,0])

軸のスケーリングをリセットして既定の範囲に戻します。

caxis auto

現在の色の範囲の値を返します。

v = caxis
v =

    -1     1

イメージ データの色軸のスケーリングの設定

米国マサチューセッツ州ケープコッドのイメージ データ X とカラーマップ map を含む cape ファイルを読み込みます。

load cape

CDataMappingscaled に設定してイメージを表示し、map カラーマップを使用します。

figure
image(X,'CDataMapping','scaled')
colormap(map)

色の範囲は 1 から 192 までのイメージ データの範囲にわたります。海の青色がカラーマップ内の最初の色で、最小のデータ値の 1 にマッピングされています。caxis を使用して色の範囲の最小値を変更すれば、海面の水位を簡単に変更できます。

4 つの異なる色の範囲の値を使用してイメージ データを表示します。

load cape

figure
colormap(map)

subplot(2,2,1)
image(X,'CDataMapping','scaled')
title('caxis = [1 192]')

subplot(2,2,2)
image(X,'CDataMapping','scaled')
caxis([4,192]) % change caxis
title('caxis = [4 192]')

subplot(2,2,3)
image(X,'CDataMapping','scaled')
caxis([7,192]) % change caxis
title('caxis = [7 192]')

subplot(2,2,4)
image(X,'CDataMapping','scaled')
caxis([10,192]) % change caxis
title('caxis = [10 192]')

詳細

すべて折りたたむ

ヒント

色軸スケーリングの詳細

インデックス付きの CData をもっており、CDataMappingscaled に設定されている surface、patch、および image グラフィックス オブジェクトは、描画のたびに、CData の値を Figure カラーマップ内の色に割り当てます。cmin 以下の CData 値はカラーマップ内の最初の色値、cmax 以上の CData 値はカラーマップ内の最後の色値に割り当てられます。中間の値 (下の式では C) をカラーマップ内の値に割り当てるため、以下の線形変換が行われます (長さは m、その行インデックスは下の式では index)。

index = fix((C-cmin)/(cmax-cmin)*m)+1;
%Clamp values outside the range [1 m]
index(index<1) = 1;
index(index>m) = m; 

参考

| | | | | | |

この情報は役に立ちましたか?