極座標軸、地理座標軸または複数の座標軸をもつチャートの作成

ChartContainer 基底クラスのサブクラスとして作成するチャートの場合、getAxes メソッドが、単一の直交 axes オブジェクトをサポートする方法を提供します。極座標軸、地理座標軸または複数の座標軸をサポートするには、座標軸を TiledChartLayout オブジェクト (チャートオブジェクトに保存されている) の子として作成し、構成しなければなりません。

単一の Polar Axes オブジェクトまたは Geographic Axes オブジェクトの作成

チャートに単一の polar axes オブジェクトまたは geographic axes オブジェクトを含めるには、次を行います。

座標軸を格納するためのプライベートプロパティを定義します。
setup メソッドで以下を行います。
- getLayout メソッドを呼び出して TiledChartLayout オブジェクトを取得します。
- 関数 polaraxes または関数 geoaxes を呼び出して座標軸を作成し、親オブジェクトとして TiledChartLayout オブジェクトを指定します。

polar axes オブジェクトを含む基本的なクラスの例を以下に示します。

classdef SimplePolar < matlab.graphics.chartcontainer.ChartContainer
    properties(Access = private,Transient,NonCopyable)
        PolarAx matlab.graphics.axis.PolarAxes
    end
    
    methods(Access = protected)
        function setup(obj)
            % Get the layout and create the axes
            tcl = getLayout(obj);
            obj.PolarAx = polaraxes(tcl);
            
            % Other setup code
            % ...
        end
        function update(obj)
            % Update the chart
            % ...
        end
    end
end

複数の axes オブジェクトのタイル表示の作成

複数の座標軸をタイル表示するには、次を行います。

axes オブジェクトを格納するプライベートプロパティを定義します。また、axes オブジェクトの配列を格納する 1 つのプロパティを定義することもできます。
setup メソッドで以下を行います。
- getLayout メソッドを呼び出して TiledChartLayout オブジェクトを取得します。
- 各座標軸が少なくとも 1 つのタイルをもつように、TiledChartLayout オブジェクトの GridSize プロパティを設定します。
- 関数 axes、polaraxes または geoaxes を呼び出して座標軸オブジェクトを作成し、親オブジェクトとして TiledChartLayout オブジェクトを指定します。
- 各 axes オブジェクトの Layout プロパティを設定して、各座標軸を目的のタイルに移動します。既定で、座標軸は最初のタイルに表示されます。

2 つの直交座標軸を含む基本的なクラスの例を以下に示します。

classdef TwoAxesChart < matlab.graphics.chartcontainer.ChartContainer
    properties(Access = private,Transient,NonCopyable)
        Ax1 matlab.graphics.axis.Axes
        Ax2 matlab.graphics.axis.Axes
    end
    
    methods(Access = protected)
        function setup(obj)
            % Get the layout and set the grid size
            tcl = getLayout(obj);
            tcl.GridSize = [2 1];
            
            % Create the axes
            obj.Ax1 = axes(tcl);
            obj.Ax2 = axes(tcl);
            
            % Move the second axes to the second tile
            obj.Ax2.Layout.Tile = 2;
        end
        function update(obj)
            % Update the chart
            % ...
        end
    end
end

例: 地理座標軸と直交座標軸を含むチャート

スクリプトを開く

次の例では、2 つの座標軸を使用して、地理データと categorical データを可視化するためのチャートのクラスを定義する方法を示します。左側の座標軸には、複数の携帯電話基地局の場所を示す地図が含まれています。右側の座標軸は、カテゴリ別の基地局の分布を示しています。

次の TowerChart クラスの定義は、以下の方法を示します。

table を格納する TowerData というパブリックプロパティを定義する。
mustHaveRequiredVariables というローカル関数を使用して table の内容を検証する。
座標軸を格納する MapAxes および HistogramAxes という 2 つのプライベートプロパティを定義する。
setup メソッドを実装する。このメソッドは TiledChartLayout オブジェクトを取得し、レイアウトのグリッドサイズを指定して座標軸を配置します。

クラスを定義するために、次のコードをエディターにコピーし、書き込み可能なフォルダーに TowerChart.m という名前で保存します。

classdef TowerChart < matlab.graphics.chartcontainer.ChartContainer
    properties
        TowerData (:,:) table {mustHaveRequiredVariables} = table([],...
            [],[],'VariableNames',{'STRUCTYPE','Latitude','Longitude'})
    end
    
    properties (Access = private,Transient,NonCopyable)
        MapAxes matlab.graphics.axis.GeographicAxes
        HistogramAxes matlab.graphics.axis.Axes
        ScatterObject matlab.graphics.chart.primitive.Scatter
        HistogramObject matlab.graphics.chart.primitive.categorical.Histogram
    end
    
    methods (Access = protected)
        function setup(obj)
            % Configure layout and create axes
            tcl = getLayout(obj);
            tcl.GridSize = [1 2];
            obj.MapAxes = geoaxes(tcl);
            obj.HistogramAxes = axes(tcl);
            
            % Move histogram axes to second tile
            obj.HistogramAxes.Layout.Tile = 2;
            
            % Create Scatter and Histogram objects
            obj.ScatterObject = geoscatter(obj.MapAxes,NaN,NaN,'.');
            obj.HistogramObject = histogram(obj.HistogramAxes,categorical.empty,...
                'Orientation','horizontal');
            
            % Add titles to the axes
            title(obj.MapAxes,"Tower Locations")
            title(obj.HistogramAxes,"Tower Types")
            xlabel(obj.HistogramAxes,"Number of Towers")
        end
        
        function update(obj) 
            % Update Scatter object
            obj.ScatterObject.LatitudeData = obj.TowerData.Latitude;
            obj.ScatterObject.LongitudeData = obj.TowerData.Longitude;
            
            % Get tower types from STRUCTYPE table variable
            towertypes = obj.TowerData.STRUCTYPE;
            
            % Check for empty towertypes before updating histogram
            if ~isempty(towertypes)
                obj.HistogramObject.Data = towertypes;
                obj.HistogramObject.Categories = categories(towertypes);
            else
                obj.HistogramObject.Data = categorical.empty;
            end
        end
    end
end

function mustHaveRequiredVariables(tbl)
% Return error if table does not have required variables
assert(all(ismember({'STRUCTYPE','Latitude','Longitude'},...
    tbl.Properties.VariableNames)),...
    'MATLAB:TowerChart:InvalidTable',...
    'Table must have STRUCTYPE, Latitude, and Longitude variables.');
end

クラスファイルを保存した後、cellularTowers.mat に格納されている table を読み込みます。次に、その table を名前と値のペアの引数として TowerChart コンストラクターメソッドに渡して、チャートのインスタンスを作成します。

load cellularTowers.mat
TowerChart('TowerData',cellularTowers);

参考