Exponenta Banner
exponenta event banner

Записать конструкторы для классов диаграмм

При разработке диаграммы как подкласса ChartContainer базовый класс предоставляет конструктор по умолчанию, который принимает необязательные аргументы пары имя-значение для задания свойств диаграммы. Например, эта команда создает экземпляр класса с именем ConfidenceChart.

ConfidenceChart('XData',x,'YData',y,'ConfidenceMargin',0.15,'Color',[1 0 0])

Написав пользовательский метод конструктора, можно предоставить интерфейс, который принимает отдельные значения аргументов и необязательные аргументы пары имя-значение. Например, можно создать пользовательский конструктор для изменения синтаксиса вызова для ConfidenceChart чтобы обе эти команды были действительными способами создания диаграммы:

ConfidenceChart(x,y,0.15)
ConfidenceChart(x,y,0.15,'Color',[1 0 0])

При записи метода конструктора:

  • Укажите входные аргументы, которые должны поддерживаться в объявлении функции. Включать varargin в качестве последнего входного аргумента для захвата любых аргументов пары имя-значение свойства, указанных пользователем.

  • Позвоните в ChartContainer перед всеми остальными ссылками на объект диаграммы.

Например, следующий метод конструктора для ConfidenceChart класс выполняет следующие задачи:

  • Проверяет количество входных аргументов и возвращает ошибку, если число меньше трех.

  • Преобразует x, y, и margin значения для аргументов пары имя-значение, ChartContainer конструктор принимает и сохраняет результаты в args.

  • Добавляет любые пользовательские аргументы пары имя-значение в конец args.

  • Проходы args в ChartContainer метод конструктора.

methods
    function obj = ConfidenceChart(x,y,margin,varargin)
        % Check for at least three inputs
        if nargin < 3
            error('Not enough inputs');
        end
            
        % Convert x, y, and margin into name-value pairs
        args = {'XData', x, 'YData', y, 'ConfidenceMargin', margin};
            
        % Combine args with user-provided name-value pairs
        args = [args varargin];
            
        % Call superclass constructor method
        obj@matlab.graphics.chartcontainer.ChartContainer(args{:});
    end
end

Пример: Диаграмма доверительных границ с пользовательским конструктором

В этом примере показано, как разработать диаграмму с пользовательским конструктором, который принимает входные аргументы одного значения и необязательные аргументы пары имя-значение. Диаграмма отображает линию с маркерами и окружающим доверительным запасом.

Создание файла программы с именем ConfidenceChart.m в папке, расположенной по пути MATLAB ®. Определите класс, выполнив следующие действия.

ШагВнедрение

Вывести из ChartContainer базовый класс.

classdef ConfidenceChart < matlab.graphics.chartcontainer.ChartContainer

Определение общих свойств.

    properties
        XData (1,:) double = NaN
        YData (1,:) double = NaN
        ConfidenceMargin (1,1) double = 0.15
        MarkerSymbol (1,:) char = 'o'
        Color (1,3) double {mustBeGreaterThanOrEqual(Color,0),...
            mustBeLessThanOrEqual(Color,1)} = [1 0 0]
    end

Определите частные свойства.

    properties(Access = private,Transient,NonCopyable)
        LineObject (1,1) matlab.graphics.chart.primitive.Line
        PatchObject (1,1) matlab.graphics.primitive.Patch
    end

Реализуйте метод пользовательского конструктора, который принимает x, y, и margin значения и необязательные аргументы пары имя-значение свойства.

 
    methods
        function obj = ConfidenceChart(x,y,margin,varargin)
            % Check for at least three inputs
            if nargin < 3
                error('Not enough inputs');
            end
            
            % Convert x, y, and margin into name-value pairs
            args = {'XData', x, 'YData', y, 'ConfidenceMargin', margin};
            
            % Combine args with user-provided name-value pairs.
            args = [args varargin];
            
            % Call superclass constructor method
            obj@matlab.graphics.chartcontainer.ChartContainer(args{:});
        end
    end

Реализация setup способ.

    methods(Access = protected)
        function setup(obj)
            % get the axes
            ax = getAxes(obj);
            
            % Create Patch and objects
            obj.PatchObject = patch(ax,NaN,NaN,'r','FaceAlpha',0.2,...
                'EdgeColor','none');
            hold(ax,'on')
            obj.LineObject = plot(ax,NaN,NaN);
            hold(ax,'off')
        end

Реализация update способ.

        function update(obj)
            % Update XData and YData of Line
            obj.LineObject.XData = obj.XData;
            obj.LineObject.YData = obj.YData;
            
            % Update patch XData and YData
            x = obj.XData;
            obj.PatchObject.XData = [x x(end:-1:1)];
            y = obj.YData;
            c = obj.ConfidenceMargin;
            obj.PatchObject.YData = [y+c y(end:-1:1)-c];
            
            % Update colors
            obj.LineObject.Color = obj.Color;
            obj.PatchObject.FaceColor = obj.Color;
            
            % Update markers
            obj.LineObject.Marker = obj.MarkerSymbol;
        end
    end
end

Затем создайте экземпляр ConfidenceChart. Укажите координаты X и Y, значение поля и обозначение маркера.

x = 0:0.2:10;
y = besselj(0,x);
ConfidenceChart(x,y,0.20,'MarkerSymbol','>');

См. также

Классы

Функции

Свойства

Связанные темы

Документация MATLAB

Поддержка