аннотации

Управляйте внешним видом блока Simscape на основе компонента

Синтаксис

annotations
   [Id1, Id2] : ExternalAccess=value;
   Icon = 'filename';
   [param1, param2] : UnitDropdown = common
end

Описание

annotations начинает раздел аннотаций, который отключен ключевым словом end. Раздел annotations в файле компонента позволяет вам предоставить аннотации, которые управляют различными косметическими аспектами блока Simscape™, сгенерированного от этого компонента.

Используйте раздел annotations для:

  • Задайте условную видимость участников компонента, таких как параметры, переменные и узлы, в значках блока и диалоговых окнах.

  • Задайте значок авторского блока и измените его на основе варианта блока.

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

Примеры

Следующий пример скрывает неподходящие параметры от диалогового окна блока на основе значения параметров управления.

component MyPipe
  parameters
    circular  = true;             % Circular pipe?
    d_in      = { 0.01, 'm' };    % Pipe internal diameter
    area      = { 1e-4, 'm^2' };  % Noncircular pipe cross-sectional area
    D_h       = { 1.12e-2, 'm' }; % Noncircular pipe hydraulic diameter
  end
  if circular 
  % Hide inapplicable parameters
    annotations
       [area, D_h] : ExternalAccess=none;
    end
    equations
       % First set of equations, for circular pipe 
    end
  else
  % Hide inapplicable parameter
    annotations
       d_in : ExternalAccess=none;
    end
    equations
       % Second set of equations, for noncircular pipe 
    end
  end
  [...] % Other parameters, variables, branches, equations
end

Следующий пример представляет тепловой порт H и изменяет индивидуально настраиваемый значок блока на основе значения параметров управления.

parameters
    thermal_effects = false; % Model thermal effects?
end
nodes (ExternalAccess=none)
   H = foundation.thermal.thermal; 
end
if thermal_effects 
  % Use icon with additional thermal port
    annotations
       H : ExternalAccess=modify;
       Icon = 'pipe_thermal.jpg';
    end
end

Следующий пример указывает, что выпадающий список для параметра Gain включает список общих модулей, таких как доступные в Конвертере PS Simulink и диалоговых окнах блока PS-Simulink Converter.

annotations
    Gain : UnitDropdown = common
end
 

Введенный в R2019a