simscape.mustBeCommensurateUnit

Подтвердите это, модули соразмерны

Описание

пример

simscape.mustBeCommensurateUnit(unitlist) выдает ошибку, если все модули в списке не положительны. Эта функция не возвращает значение. Сообщение об ошибке сообщает о модуле, сопоставленном с первым аргументом в списке и первым модулем, который не соразмерен с этим модулем.

simscape.mustBeCommensurateUnit вызывает... функция, чтобы определить, соразмерны ли модули.

Примеры

свернуть все

Создайте simscape.Value объект:

 v1 = simscape.Value([100, 200, 300], "cm/s");

Создайте скалярный simscape.Unit объекты:

u1 = simscape.Unit("mm/s");
u2 = simscape.Unit("rad/s");

Подтвердите это, модули трех объектов соразмерны с модулем метров в секунду:

 simscape.mustBeCommensurateUnit(v1,u1,u2,"m/s")
Unit 'cm/s' is not commensurate with 'rad/s'.

Сообщение об ошибке сообщает о модуле, сопоставленном с первым аргументом, v1 (cm/s), и затем первый модуль в остальной части списка, который не соразмерен с cm/s рад/с).

Эта функция вычисляет область прямоугольника:

 function a = area(length, width)
  arguments
    length (1, 1) simscape.Value {simscape.mustBeCommensurateUnit(length, 'm')}
    width  (1, 1) simscape.Value {simscape.mustBeCommensurateUnit(width, 'm')}
  end
  a = length * width;
end

Вызовите функцию с помощью двух simscape.Value объекты в качестве аргументов:

v1 = simscape.Value(10, "cm");
v2 = simscape.Value(1, "kg");
area(v1,v2)
Error using area (line 4)
 area(v1,v2)
          ↑
Invalid argument at position 2. Unit 'kg' is not commensurate with 'm'.

Сообщение об ошибке сообщает о положении недействительного аргумента, его связанный модуль (kg), и ожидаемый соразмерный модуль (m).

Входные параметры

свернуть все

Список модулей для сравнения в виде векторов символов, строк, скалярного simscape.Unit объекты или simscape.Value объекты. Для simscape.Value объекты, функция сравнивает модуль объекта с другими модулями в списке.

Советы

  • simscape.mustBeCommensurateUnit спроектирован, чтобы использоваться для валидации аргумента функции.

Введенный в R2021b
Для просмотра документации необходимо авторизоваться на сайте