Если у вас есть Simulink® Coder™, можно включать исходный код MATLAB® как комментарии в коде, сгенерированном для блока MATLAB Function. Включая эту информацию в сгенерированном коде позволяет:
Коррелируйте сгенерированный код со своим исходным кодом.
Изучите, как сгенерированный код реализует ваш алгоритм.
Оцените качество сгенерированного кода.
Когда вы выбираете параметр MATLAB source code as comments, сгенерированный код включает:
Исходный код как комментарий сразу после тега трассируемости. То, когда вы включаете трассируемость и генерируете код для целей ERT (требует Embedded Coder®), теги трассируемости являются гиперссылками на исходный код. Для получения дополнительной информации смотрите Трассируемость Использования в блоках MATLAB function (Embedded Coder).
Для примеров и информации о местоположении комментариев в сгенерированном коде, смотрите Местоположение Комментариев в Сгенерированном коде (Embedded Coder).
Функциональный текст справки в теле функции в сгенерированном коде. Функциональный текст справки является первым комментарием после подписи функции MATLAB. Это предоставляет информацию о возможностях функции и как использовать его.
Примечание
С Embedded Coder можно также включать функциональный текст справки в баннер функции сгенерированного кода. Для получения дополнительной информации смотрите, Включают Комментарии пользователя MATLAB в Сгенерированный код (Embedded Coder).
Включать исходный код MATLAB как комментарии в коде, сгенерированном для блока MATLAB Function:
На вкладке C Code нажмите Configuration Parameters.
В панели Code Generation > Comments выберите MATLAB source code as comments и нажмите Apply.
Комментарии, содержащие исходный код, появляются после тега трассируемости в сгенерированном коде можно следующим образом.
/* '<S2>:1:18' for y = 1 : 2 : (HEIGHT-4) */
'<S2>:1:18'. Выбор параметра MATLAB source code as comments генерирует for y = 1 : 2 : (HEIGHT-4) комментарий.Комментарий, содержащий исходный код, предшествует сгенерированному коду, который реализует оператор исходного кода. Этот комментарий появляется после комментариев, что вы добавляете, которые предшествуют сгенерированному коду. Комментарии разделяются от сгенерированного кода, потому что операторы присвоены функционировать выходные параметры.
КОД MATLAB
function [x y] = straightline(r,theta) %#codegen % Convert polar to Cartesian x = r * cos(theta); y = r * sin(theta);
Прокомментированный код С
/* MATLAB Function 'straightline': '<S1>:1' */
/* Convert polar to Cartesian */
/* '<S1>:1:4' x = r * cos(theta); */
/* '<S1>:1:5' y = r * sin(theta); */
straightline0_Y.x = straightline0_U.r * cos(straightline0_U.theta);
/* Outport: '<Root>/y' incorporates:
* Inport: '<Root>/r'
* Inport: '<Root>/theta'
* MATLAB Function Block: '<Root>/straightline'
*/
straightline0_Y.y = straightline0_U.r * sin(straightline0_U.theta);
Комментарий для if оператор сразу предшествует коду, который реализует оператор. Этот комментарий появляется после комментариев, что вы добавляете, которые предшествуют сгенерированному коду. Комментарии для elseif и else пункты сразу появляются после кода, который реализует пункт и прежде чем код сгенерировал для операторов в пункте.
КОД MATLAB
function y = ifstmt(u,v)
%#codegen
if u > v
y = v + 10;
elseif u == v
y = u * 2;
else
y = v - 10;
end
Прокомментированный код С
/* MATLAB Function 'MLFcn': '<S1>:1' */
/* '<S1>:1:3' if u > v */
if (MLFcn_U.u > MLFcn_U.v) {
/* Outport: '<Root>/y' */
/* '<S1>:1:4' y = v + 10; */
MLFcn_Y.y = MLFcn_U.v + 10.0;
} else if (MLFcn_U.u == MLFcn_U.v) {
/* Outport: '<Root>/y' */
/* '<S1>:1:5' elseif u == v */
/* '<S1>:1:6' y = u * 2; */
MLFcn_Y.y = MLFcn_U.u * 2.0;
} else {
/* Outport: '<Root>/y' */
/* '<S1>:1:7' else */
/* '<S1>:1:8' y = v - 10; */
MLFcn_Y.y = MLFcn_U.v - 10.0;
Комментарий для for заголовок оператора сразу предшествует сгенерированному коду, который реализует заголовок. Этот комментарий появляется после комментариев, что вы добавляете, которые предшествуют сгенерированному коду.
КОД MATLAB
function y = forstmt(u)
%#codegen
y = 0;
for i=1:u
y = y + 1;
endПрокомментированный код С
/* MATLAB Function 'MLFcn': '<S1>:1' */
/* '<S1>:1:3' y = 0; */
rtb_y = 0.0;
/* '<S1>:1:5' for i=1:u */
for (i = 1.0; i <= MLFcn_U.u; i++) {
/* '<S1>:1:6' y = y + 1; */
rtb_y++;
Комментарий для while заголовок оператора сразу предшествует сгенерированному коду, который реализует заголовок оператора. Этот комментарий появляется после комментариев, что вы добавляете, которые предшествуют сгенерированному коду.
Комментарий для switch заголовок оператора сразу предшествует сгенерированному коду, который реализует заголовок оператора. Этот комментарий появляется после комментариев, что вы добавляете, что предшествуют сгенерированному коду. Комментарии для case и otherwise пункты сразу появляются после сгенерированного кода, который реализует пункт, и прежде чем код сгенерировал для операторов в пункте.
Комментарии пользователя MATLAB включают функциональный текст справки и другие комментарии. Функциональный текст справки является первым комментарием после подписи функции MATLAB. Это предоставляет информацию о возможностях функции и как использовать его. Можно включать комментарии пользователя MATLAB в код, сгенерированный для блока MATLAB Function.
На вкладке C Code нажмите Configuration Parameters.
В панели Code Generation > Comments выберите комментарии пользователя MATLAB (Embedded Coder) и нажмите Apply.
Поскольку включая исходный код MATLAB как комментарии, блок MATLAB Function имеет эти ограничения:
Вы не можете включать исходный код MATLAB как комментарии для:
Функции тулбокса MathWorks®
Псевдокод
Цели симуляции
Блоки Stateflow® Truth Table
Внешний вид или местоположение комментариев могут варьироваться в зависимости от этих условий:
Комментарии могут все еще появиться в сгенерированном коде, даже если код реализации устраняется, например, из-за сворачивания констант.
Комментарии могут быть устранены из сгенерированного кода, если полный блок функции или кода устраняется.
Для определенной оптимизации комментарии могут быть разделены от сгенерированного кода.
Сгенерированный код включает по закону требуемые комментарии из исходного кода MATLAB, даже если вы не принимаете решение включать комментарии исходного кода в сгенерированный код.