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

Составьте передающую таблицу программно

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

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

где:

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

Соединенный блочный экземпляр сопоставлен со специфичными для экземпляра параметрами под названием InstanceData. Когда вы создаете версии блока библиотеки, наборы параметра могут быть добавлены или удалили из InstanceData.

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

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

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

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

function outData = TransformationFcn(inData)

где:

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

Рассмотрите блок Compare to Constant в Библиотеке ^Simulink®. Необходимо создать версии этого блока, не меняя имя и блок path, но добавить параметры к более новому блоку библиотеки.

Таблица показывает различие в параметре в двух версиях блока Compare to Constant.

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 устанавливаются так, чтобы старые ссылки библиотеки работали.

Этот пример показывает функцию преобразования для блока Compare to Constant, чтобы добавить параметр 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;