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

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

В командной строке можно создать простую таблицу пересылки, определяющую старые расположения и новые расположения блоков, которые были перемещены внутри библиотеки или в другую библиотеку. Таблицу пересылки можно связать с библиотекой, установив ее ForwardingTable параметр для массива ячеек из двухэлементных массивов ячеек, каждый из которых задает старый и новый путь перемещаемого блока. Например, синтаксис для создания таблицы пересылки и назначения ее библиотеке с именем Lib1 является:

set_param('Lib1', 'ForwardingTable', {{'Lib1/A', 'Lib2/A'} 
{'Lib1/B', 'Lib1/C'}});

где:

Функции преобразования

Экземпляр связанного блока связан с параметрами экземпляра, вызываемыми InstanceData. При создании версий блока библиотеки наборы параметров могут быть добавлены или удалены из InstanceData.

Функция преобразования исправляет несоответствие параметров в InstanceData новых и старых библиотечных ссылок, обеспечивая тем самым продолжение работы библиотечных ссылок.

Можно определить функцию преобразования с помощью файла MATLAB в пути, а затем указать функцию в столбце Функция преобразования таблицы переадресации.

Новый путь блока, определенный в таблице пересылки, переопределяет значения, определенные в функции преобразования. Если новый путь блока является динамическим значением, которое изменяется в зависимости от определенных условий, то новый путь блока должен быть определен только с помощью функции преобразования.

Синтаксис функции преобразования должен быть следующим:

function outData = TransformationFcn(inData)

где:

Общая функция преобразования может иметь множество локальных функций, определенных в ней. Функция вызывает соответствующие локальные функции на основе старых имен и версий блоков. Это можно использовать для объединения нескольких локальных функций в одну функцию преобразования, чтобы избежать наличия множества функций преобразования на пути MATLAB.

Рассмотрим блок «Сравнить с константой» в библиотеке Simulink ®. Необходимо создать версии этого блока без изменения имени и пути блока, но добавить параметры в новый блок библиотеки.

В таблице показано различие параметров в двух версиях блока «Сравнить с константой».

Block {
BlockType		      Reference
Name		      "Compare\nTo Constant"
Ports		        [1, 1]
Position		     [210, 60, 250, 100]
SourceBlock	  "fixpt_lib_4/Logic & Comparison/Compare\nTo Constant"
SourceType	    "Fixed-Point Compare To Constant"
relop	           "=="
const	           "3.0"
    }

Block {
BlockType		      Reference
Name		      "Compare\nTo Constant"
SID		                      "15"
Ports		                     [1, 1]
Position		      [125, 50, 155, 80]
ZOrder		      -5
LibraryVersion	      "1.271"
SourceBlock	       "simulink/Logic and Bit\nOperations/Compare\nTo Constant"
SourceType	        "Compare To Constant"
relop		          "<="
const		             "3.0"
OutDataTypeStr	      "boolean"
ZeroCross		      on
    }

Новая версия блока Compare to Constant имеет дополнительные параметры (OutDataTypeStr и ZeroCross), связанной с ним. Для таких случаев функция преобразования должна гарантировать, что дополнительные параметры в InstanceData устанавливаются таким образом, чтобы старые ссылки библиотеки работали.

В этом примере показана функция преобразования блока «Сравнить с константой» для добавления OutDataTypestr параметр со значением uint8.

function [outData] = TransformationCompConstBlk(inData)
outData.NewBlockPath = ''; % No change in the library block path
outData.NewInstanceData = [];
instanceData = inData.InstanceData;
% Get the field type 'Name' from instanceData
[ParameterNames{1:length(instanceData)}] = instanceData.Name;

if (~ismember('OutDataTypeStr',ParameterNames))
    % OutDataTypeStr parameter is not present in old link. Add it and set value uint8
    instanceData(end+1).Name = 'OutDataTypeStr';
    instanceData(end).Value = 'uint8';
end

outData.NewInstanceData = instanceData;