MATLAB の caxis()関数

このチュートリアルでは、MATLAB の caxis() または clim() 関数を使用したカラーマップ制限の設定について説明します。

MATLAB で caxis() 関数を使用する

caxis() 関数は、MATLAB のバージョン R2022a では clim() 関数に名前が変更され、さまざまなプロットでカラーマップの制限を設定するために使用されます。MATLAB のバージョンがバージョン R2022a より古い場合は、caxis() 関数を使用できます。バージョンが R2022a 以降の場合は、clim() 関数を使用する必要があります。

caxis() または clim() 関数には、以下に示す 5つの構文があります。

構文：

clim(axis_limits)
clim("auto")
clim("manual")
clim(target_axis,___)
lims_object = clim

clim(axis_limits) は、axis_limits 変数に存在する制限に従ってカラーマップの制限を設定します。axis_limits 変数は 2 要素のベクトルである必要があります。最初の値は最小制限を定義し、2 番目の値は最大制限を定義します。

デフォルトのカラーマップに新しいカラーマップ制限の最小制限以下の値がある場合、前の値が新しいカラーマップの最初の行にマップされます。デフォルトのカラーマップに新しいカラーマップ制限の最大制限以上の値がある場合、前の値が新しいカラーマップの最後の行にマップされます。

clim("auto") は関数のデフォルトの動作であり、プロットのインデックスに従ってカラーマップの制限を設定します。上記の構文の代わりに clim("auto") または caxis auto コマンドを使用して、制限を auto に設定することもできます。

clim("manual") は、制限の自動更新をオフにします。上記の構文の代わりに clim("manual") または caxis manual コマンドを使用して、自動制限更新を無効にすることもできます。

clim(target_axis,___) は、カラーマップ値を変更する軸を指定するために使用されます。この構文は、現在のプロットに存在するすべてのカラーマップのカラーマップ制限を変更したくない場合に役立ちます。

lims_object = clim は、現在のカラーマップのカラーマップ制限を返します。たとえば、サーフェスプロットのデフォルトのカラーマップ制限を変更してみましょう。

サンプルコード：

[x_axis,y_axis] = meshgrid(-6:.5:6);
z_axis = x_axis.^2 + y_axis.^2;
surf(z_axis);
colorbar
previous_limits = caxis
caxis([20 50])
current_limits = caxis

出力：

meshgrid() 関数を使用して、サーフェスプロットのグリッドを作成しました。surf() 関数を使用して表面プロットを作成し、colorbar コマンドを使用して、プロットに存在する対応する色の値を示す色のバーを作成します。

出力は、以前のカラーマップの制限が 0 から 72 であり、新しい制限が 20 から 50 であることを示しています。caxis() または clim() 関数の詳細については、この記事を確認してください。