exponenta event banner

himl_0001: Использование стандартных заголовков функций MATLAB

Идентификатор: Заголовокhiml_0001: Использование стандартных заголовков функций MATLAB ®
Описание

При использовании функций MATLAB используйте стандартизированный заголовок для предоставления информации о назначении и использовании функции.

Объяснение

Стандартизированный заголовок улучшает удобочитаемость и документирование функций MATLAB. Заголовок должен содержать описание функции и информацию об использовании.

Проверки помощника по моделиПроверка использования стандартных заголовков функций MATLAB (Simulink Check)
Ссылки

  • DO-331, Раздел MB.6.3.4.e - Исходный код отслеживается в соответствии с требованиями низкого уровня

  • ISO 26262-6, таблица 1 (1g) - Использование направляющих стилей

См. также
Последнее изменениеR2018b
Примеры

Типичный стандартизированный заголовок функции включает в себя:

  • Имя функции

  • Описание

  • Входы и выходы (по возможности, включая размер и тип)

  • Допущения и ограничения

  • Журнал изменений

Пример:

% FUNCTION NAME:
%   avg
%
% DESCRIPTION:
%   Compute the average of three inputs
%
% INPUT:
%   in1 - (double) Input one
%   in2 - (double) Input two
%   in3 - (double) Input three
%
% OUTPUT:
%   out - (double) Calculated average of the three inputs
%
% ASSUMPTIONS AND LIMITATIONS:
%   None
%
% REVISION HISTORY:
%   05/02/2018 - mmyers
%       * Initial implementation
%