exponenta event banner

setname

Установка имен сигналов ввода-вывода в модели завода ПДК

Описание

пример

setname(MPCobj,'input',i,name) изменяет имя ith входной сигнал в MPCobj кому name. Это эквивалентно MPCobj.Model.Plant.InputName{i}=nameи обе команды, а также обновление только для чтения Name поле соответствующей структуры в MPCobj.ManipulatedVariables (если входные данные являются переменной манипуляции), или MPCobj.DisturbanceVariables (если вход является переменной возмущения).

setname(MPCobj,'output',i,name) изменяет имя ith выходной сигнал в MPCobj кому name. Это эквивалентно MPCobj.Model.Plant.OutputName{i} =nameи обе команды, а также обновление только для чтения Name поле соответствующей структуры в MPCobj.OutputVariables.

Примеры

свернуть все

Создайте завод и объект MPC, а затем задайте имена некоторых входных и выходных сигналов.

mpcverbosity off;                           % turn off mpc messages

% create plant model
plant = rss(4,4,4);                         % random state space
plant.D = 0;                                % set D matrix to zero

% set signals type in plant model
plant = setmpcsignals(plant,'MV',1,'MD',3,'UD',4,'MO',1,'UO',[3 4]);

% create MPC object
mpcobj=mpc(plant,1);                        % sampling time = 1 second

Задать имена входных сигналов

% set input signal names
setname(mpcobj,'input',1,'Jim')            % set name of first input signal
setname(mpcobj,'input',2,'Joe')            % set name of second input signal
setname(mpcobj,'input',3,'Jeff')           % set name of third input signal

Проверить наименования входных сигналов

% get input signal names
getname(mpcobj,'input',2)                   % get name of second input signal
ans =
    'Joe'

% alternatively
mpcobj.ManipulatedVariables(2).Name
ans =
    'Joe'

mpcobj.DisturbanceVariables(1).Name
ans =
    'Jeff'

mpcobj.Model.Plant.InputName{3}
ans =
    'Jeff'

mpcobj.Model.Plant.InputName
ans =
  4×1 cell array
    {'Jim' }
    {'Joe' }
    {'Jeff'}
    {'UD1' }

Установить и проверить наименования выходных сигналов

% set output signal names
setname(mpcobj,'output',1,'Laura')           % set name of first output signal
setname(mpcobj,'output',2,'Diana')           % set name of second output signal
setname(mpcobj,'output',3,'Emily')           % set name of third output signal

% get output signal names
getname(mpcobj,'output',2)                   % get name of second input signal
ans =
    'Diana'

% alternatively
mpcobj.OutputVariables(2).Name
ans =
    'Diana'

mpcobj.Model.Plant.OutputName{2}
ans =
    'Diana'

mpcobj.Model.Plant.OutputName
ans =
  4×1 cell array
    {'Laura'}
    {'Diana'}
    {'Emily'}
    {'UO2'  }

Обратите внимание, что сигналы не указаны setmpcsignals считаются измеряемыми входами (для неуточненных входов) или измеряемыми выходами (для неуточненных выходов).

Входные аргументы

свернуть все

Контроллер прогнозирования модели, указанный как объект контроллера MPC. Для создания контроллера MPC используйте mpc.

Это целое число указывает, что имя iНеобходимо установить сигнал th.

Устанавливаемый номер сигнала.

Пример: 2

Это имя, которое будет присвоено ith входной или выходной сигнал в MPCobj. Это не влияет на то, классифицируется ли сигнал как управляемая переменная, измеренное или неизмеренное возмущение, измеренный или неизмеренный выход.

Для входных сигналов name заменяет содержимое MPCobj.Model.Plant.InputName{i}, а также только для чтения Name поле соответствующей структуры в MPCobj.ManipulatedVariables (если входные данные являются переменной манипуляции), или MPCobj.DisturbanceVariables (если вход является переменной возмущения).

Для выходных сигналов name заменяет содержимое MPCobj.Model.Plant.OutputName{i}, а также только для чтения Name поле соответствующей структуры в MPCobj.OutputVariables.

Совет

Примечание

Name поля связанных с переменной структур в ManipulatedVariables, OutputVariables, и DisturbanceVariables в MPCobj доступны только для чтения. Необходимо использовать setname для назначения имен сигналов или эквивалентного изменения Model.Plant.InputName и Model.Plant.OutputName свойства объекта MPC.

Примечание

Ни один из Name свойства для сигналов в MPCobj влияет на то, классифицируется ли сигнал как управляемая переменная, измеренное или неизмеренное возмущение, измеренный или неизмеренный выход. Для изменения типа сигнала необходимо либо переназначить его с помощью setmpcsignal на объекте завода и воссоздать объект MPC для этого завода, или необходимо воссоздать все затронутые структуры сигналов контроллера и использовать set назначение их объекту MPC (не рекомендуется).

См. также

| |

Представлен до R2006a