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

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

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

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

где:

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

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

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

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

Новый блок 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;