이 페이지는 기계 번역을 사용하여 번역되었습니다. 영어 원문을 보려면 여기를 클릭하십시오.

setMetricIDs

클래스: slmetric.dashboard.CustomWidget
네임스페이스: slmetric.dashboard

(제거 예정) 맞춤 메트릭 대시보드 위젯에 대한 메트릭 식별자 설정

Metrics Dashboard 사용자 인터페이스, metricdashboard 기능, slmetric 패키지 API 및 해당 사용자 정의는 향후 릴리스에서 제거될 예정입니다. 자세한 내용은 Migrating from Metrics Dashboard to Model Maintainability Dashboard를 참조하세요.

구문

setMetricIDs(CustomWidget, metricID)

설명

setMetricIDs(CustomWidget, metricID)는 지표 식별자를 slmetric.dashboard.CustomWidget 개체에 할당합니다.

사용자 정의 위젯은 지정한 지표 ID 수에 맞게 자동으로 크기가 조정됩니다. 예를 들어, 사용자 정의 막대 차트 위젯을 생성하고 두 개의 지표 ID를 지정하는 경우 막대 차트 위젯은 막대 차트의 두 막대를 사용하여 지표 결과를 표시합니다. 예를 보려면 Create Layout with Custom Metric를 참조하세요.

입력 인수

CustomWidget — 사용자 정의 위젯 객체

slmetric.dashboard.CustomWidget 개체

메트릭 식별자를 할당하려는 slmetric.dashboard.CustomWidget 개체입니다. slmetric.dashboard.CustomWidget 개체는 지표 식별자에 대한 지표 데이터를 시각화하는 수단입니다.

데이터형: char

metricID — 메트릭 식별자

character vectorstring scalar

slmetric.dashboard.CustomWidget 개체와 연결된 지표 식별자입니다.

예제

그룹에 사용자 정의 위젯 추가

비가상 블록 수를 계산하는 사용자 지정 메트릭을 만듭니다. 지표 대시보드에 이 지표를 표시하려면 위젯을 지정하세요. 크기 그룹에 추가합니다.

다음을 입력하여 vdp 모델을 엽니다.

openExample('simulink_general/VanDerPolOscillatorExample')

사용자 정의 메트릭 클래스를 만듭니다.

className = 'nonvirtualblockcount';
slmetric.metric.createNewMetricClass(className);

이 코드를 nonvirtualblockcount.m 파일에 추가하여 비가상 블록 수 메트릭을 만듭니다.

classdef nonvirtualblockcount < slmetric.metric.Metric
    %nonvirtualblockcount calculates number of nonvirtual blocks per level.
    % BusCreator, BusSelector and BusAssign are treated as nonvirtual.
    properties
        VirtualBlockTypes = {'Demux','From','Goto','Ground', ...
            'GotoTagVisibility','Mux','SignalSpecification', ...
            'Terminator','Inport'};
    end
    
    methods
    function this = nonvirtualblockcount()
        this.ID = 'nonvirtualblockcount';
        this.Name = 'Nonvirtual Block Count';
        this.Version = 1;
        this.CompileContext = 'None';
        this.Description = 'Algorithm that counts nonvirtual blocks per level.';
        this.AggregatedValueName = 'Nonvirtual Blocks (incl. Descendants)'
        this.ValueName = 'Nonvirtual Blocks'
        this.ComponentScope = [Advisor.component.Types.Model, ...
            Advisor.component.Types.SubSystem];
        this.AggregationMode = slmetric.AggregationMode.Sum;
        this.ResultChecksumCoverage = true;
        this.SupportsResultDetails = true;
            
    end

    function res = algorithm(this, component)
        % create a result object for this component
        res = slmetric.metric.Result();	

        % set the component and metric ID
        res.ComponentID = component.ID;
        res.MetricID = this.ID;
        
        % Practice
        D1=slmetric.metric.ResultDetail('identifier 1','Name 1');
        D1.Value=0;
        D1.setGroup('Group1','Group1Name');
        D2=slmetric.metric.ResultDetail('identifier 2','Name 2');
        D2.Value=1;
        D2.setGroup('Group1','Group1Name');
        
        

        % use find_system to get all blocks inside this component
        blocks = find_system(getPath(component), ...
            'SearchDepth', 1, ...
            'Type', 'Block');

        isNonVirtual = true(size(blocks));

        for n=1:length(blocks)
            blockType = get_param(blocks{n}, 'BlockType');

            if any(strcmp(this.VirtualBlockTypes, blockType))
                isNonVirtual(n) = false;
            else
                switch blockType
                    case 'SubSystem'
                        % Virtual unless the block is conditionally executed
                        % or the Treat as atomic unit check box is selected.
                        if strcmp(get_param(blocks{n}, 'IsSubSystemVirtual'), ...
                                'on')
                            isNonVirtual(n) = false;
                        end
                    case 'Outport'
                        % Outport: Virtual when the block resides within
                        % SubSystem block (conditional or not), and 
                        % does not reside in the root (top-level) Simulink window.
                        if component.Type ~= Advisor.component.Types.Model
                            isNonVirtual(n) = false;
                        end
                    case 'Selector'
                        % Virtual only when Number of input dimensions 
                        % specifies 1 and Index Option specifies Select 
                        % all, Index vector (dialog), or Starting index (dialog).
                        nod = get_param(blocks{n}, 'NumberOfDimensions');
                        ios = get_param(blocks{n}, 'IndexOptionArray');

                        ios_settings = {'Assign all', 'Index vector (dialog)', ...
                            'Starting index (dialog)'};

                        if nod == 1 && any(strcmp(ios_settings, ios))
                            isNonVirtual(n) = false;
                        end
                    case 'Trigger'
                        % Virtual when the output port is not present.
                        if strcmp(get_param(blocks{n}, 'ShowOutputPort'), 'off')
                            isNonVirtual(n) = false;
                        end
                    case 'Enable'
                        % Virtual unless connected directly to an Outport block.
                        isNonVirtual(n) = false;

                        if strcmp(get_param(blocks{n}, 'ShowOutputPort'), 'on')
                            pc = get_param(blocks{n}, 'PortConnectivity');

                            if ~isempty(pc.DstBlock) && ...
                                    strcmp(get_param(pc.DstBlock, 'BlockType'), ...
                                    'Outport')
                                isNonVirtual(n) = true;
                            end
                        end
                end
            end
        end

        blocks = blocks(isNonVirtual);

        res.Value = length(blocks);
    end
    end
end

메트릭 저장소에 새 메트릭을 등록합니다.

[id_metric,err_msg] = slmetric.metric.registerMetric(className);

시작하려면 메트릭 대시보드 레이아웃에 대한 기본 구성을 엽니다.

conf = slmetric.dashboard.Configuration.open();

slmetric.dashboard.Configuration 개체에서 slmetric.dashboard.Layout 개체를 가져옵니다.

layout = getDashboardLayout(conf);

레이아웃 개체에 있는 위젯 개체를 가져옵니다.

layoutWidget = getWidgets(layout);

Simulink 블록 수 메트릭을 나타내는 위젯을 제거합니다.

sizeGroup = layoutWidget(2); 
sizeGroupWidgets = sizeGroup.getWidgets(); 
sizeGroup.removeWidget(sizeGroupWidgets(1));

비가상 블록 수 메트릭을 표시하는 위젯을 추가합니다. 사용자 정의 위젯의 경우 기본 시각화 유형은 단일 값입니다. 다른 시각화 기술을 사용하려면 VisualizationType 속성에 다른 값을 지정하십시오.

newWidget = sizeGroup.addWidget('Custom', 1);
newWidget.Title = ('Nonvirtual Block Count'); 
newWidget.setMetricIDs('nonvirtualblockcount');
newWidget.setWidths(slmetric.dashboard.Width.Medium);
newWidget.setHeight(70);

사용자 정의 위젯을 그룹의 다른 위젯과 구분하는 선이 있는지 여부를 지정합니다. 이 명령은 위젯 오른쪽에 줄이 있음을 지정합니다.

s.top = false;
s.bottom = false;
s.left = false;
s.right = true;
newWidget.setSeparators([s, s, s, s]);

구성 개체를 저장합니다. 이 명령은 API 정보를 XML 파일로 직렬화합니다.

save(conf,'Filename','DashboardConfig.xml');

활성 구성을 설정합니다.

slmetric.dashboard.setActiveConfiguration(fullfile(pwd,'DashboardConfig.xml'));

vdp 모델에 대한 지표 대시보드를 엽니다.

metricsdashboard vdp

모든 메트릭을 실행하려면 모든 메트릭 버튼을 클릭하세요.

버전 내역

R2018b에 개발됨

R2022a: Metrics Dashboard이 제거됩니다

Metrics Dashboard 사용자 인터페이스, metricdashboard 기능, slmetric 패키지 API 및 해당 사용자 정의는 향후 릴리스에서 제거될 예정입니다. 자세한 내용은 Migrating from Metrics Dashboard to Model Maintainability Dashboard를 참조하세요.

참고 항목

slmetric.dashboard.setActiveConfiguration | slmetric.dashboard.getActiveConfiguration

도움말 항목

• Collect Model Metric Data by Using the Metrics Dashboard
• Create Layout with Custom Metric
• Customize Metrics Dashboard Layout and Functionality