Валисы и расчеты

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

Создание вали

Вы можете создать вали в блоке, сначала нажав на символ "+" в правом нижнем углу экрана. Затем введите название (это может быть любое название или название валитипа - 1), формулу и единицу измерения (обязательно - 2), единицу отображения (необязательно - 3) и нажмите "Создать" или "Создать и добавить новый" (см. рис Adding a Vali). Для получения информации о единицах измерения и их преобразовании обратитесь к разделу "Единицы измерения и автоматическое преобразование единиц измерения".

Кроме того, вы можете решить, в какие блоки вы хотите добавить этот вали (4).

Pro-tip: В поле "Формула и единица измерения" нажмите "\", чтобы получить список возможных типов вычислений.

Добавление вали - всплывающее окно для добавления различных типов вали.

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

Type	Use-case
Вали	Свойство блока, которое имеет только одно единственное значение, например, масса, стоимость, плотность.
Матрица	Матрица - это группа отдельных Вали, упорядоченных по строкам и столбцам. Матричные Вали обычно используются, когда свойство Блока имеет различные режимы. Например, энергопотребление в разных режимах, значения инерции по разным осям.
Текстовые Вали	Вали, в которых хранятся строки/текст, например,
DateVali	Вали, хранящий информацию о дате, например,
Набор данных	Здесь пользователь может импортировать или добавить значения набора данных, создать график и использовать их значения для расчета других значений.

Добавление формул

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

В поле "Формула и единица измерения" пользователь может ссылаться на вали, которые доступны как в данном проекте, так и в других проектах. Для этого можно перейти в раздел "Формула и единица измерения" и набрать “$”, откроется небольшое диалоговое окно, внутри которого будут находиться Valis (см. рис Calling Valis). Пользователи могут вводить ключевые слова, чтобы легко найти нужный валис.

Вызов Valis - В любом месте портала Requirements & Systems Portal вы можете использовать символ доллара "$", чтобы открыть выпадающий список, который показывает любой объект, на который можно сослаться (например, Valis, Requirements и т. д.).

Если пользователь хочет использовать Valis из другого проекта, он может прокрутить диалоговое окно вниз до конца и выбрать опцию “show other projects”.

Редактор формул использует синтаксис Latex для удобного отображения формул. Это означает, что при вводе sqrt() символ квадратного корня будет автоматически преобразован в символ квадратного корня. Редактор также включает автоматическое завершение скобок.

Основные типы формул

Вы можете

• использовать фиксированное значение, например 42.7kg

• использовать формулу, например 5/(3+17.3*9)

• использовать другие валиды, используя $ знак: $car.speed+5

В формулах доступны следующие математические операции:

• +, -, *, /

• %(операция по модулю)

• ^

• sqrt()

• exp()

• log10(), ln(), log()

• sin(), cos(), tan()

• asin(), acos(), atan()

• sinh(), cosh(), tanh()

• fabs(): возвращает абсолютное значение

• soc() = "Сумма дочерних": сумма всех значений одного типа в подблоках

• poc() = "Произведение детей": произведение всех Вали одного типа в субблоках

В формулах также можно использовать следующие логические функции:

• if(condition, formula_if_true, formula_if_false)

• max(formula1, formula2)

• min(formula1, formula2)

Встроенные функции Портала требований и систем:

• soc(): означает "сумма дочерних", суммирует все Вали одного типа в Блоках на один уровень ниже

• rssoc(): Обозначает "корень квадратный из суммы детей" sqrt(x1^2+x2^2+⋯+xn^2). Например, если у вас есть три массы 2 кг, 5 кг и 6 кг, функция rssoc даст вам результат 8,062257

• aoc(): означает "среднее значение детей", вычисляет среднее значение Валиса того же типа в блоках на один уровень ниже

• poc(): означает "произведение детей", умножает все Вали одного типа в Блоках на один уровень ниже

• average_of_datasets() или aod(): результат Вали - это среднее значение для каждой точки наборов данных, принадлежащих этой Вали. Если имеется только один набор данных, то этот набор данных является результатом и используется в дальнейших расчетах

• sum_of_datasets() или sod(): результат Вали - это сумма для каждой точки наборов данных, принадлежащих этой Вали. Если имеется только один набор данных, то этот набор данных является результатом и используется в дальнейших вычислениях

• property($vali, property_name): Получить свойство вали. Для имени_свойства возможны следующие варианты:

  • min

  • max (чтобы получить минимальное и максимальное значения соответственно)

  • wc_minus

  • wc_plus (для получения минуса и плюса наихудшего случая, соответственно)

• minoc(): Минимум детей. Возвращает минимальное значение всех Вали с тем же типом в подблоках

• maxoc(): Максимум детей. Возвращает максимальное значение всех Valis с тем же типом в подблоках

• round(): Встроенная round( ) повторяет спецификации функции round в Python, в которой значения округляются до ближайшего кратного 10 в степени минус ndigits

Пример формул:

• $SolarPanel.width * $SolarPanel.length

• max(soc(), $SolarPanel.lowest_mass)

• if($SolarPanel.width*2 > $SolarPanel.length, 10, 5)

Vali Information

Вы можете посмотреть дополнительную информацию о Vali, щелкнув по его имени. Откроется представление подробностей (1) и пользователь сможет найти информацию (2). См. рисунок Vali Information для получения дополнительной информации.

Информация о вали - при нажатии на вали открывается окно с дополнительной информацией. Здесь вы можете определить дополнительные свойства, добавить описание и определить воздействия.

На вкладке "Информация" у пользователей есть несколько возможностей добавить/изменить маржи/единицы, а также добавить требования (мин/макс). Требования (min/max) - это ограничения, которые вы устанавливаете для конкретного свойства. При увеличении или уменьшении значения или худшего случая, а также при превышении/понижении значений ниже пределов требований, Requirements & Systems Portal выдает предупреждение рядом с именем Vali. Дополнительные сведения см. в разделе "Предупреждения".

Обратите внимание, что общая маржа, представленная в свойствах вали, - это маржа блока и общая накопленная маржа дочерних блоков. Для получения дополнительной информации о полях посетите нашу справочную страницу по полям.

ID: iD - это случайное число, которое автоматически добавляется Valiengine, используемым в Backend. Вы можете ввести ID вали в поле поиска Rest API, чтобы найти вали. Пожалуйста, обратитесь к документации Rest API.

Name: здесь вы можете ввести и отредактировать имя вали.

Description: в поле описания вы можете ввести описание вали. Вы также можете форматировать и редактировать задания, как показано ниже.

Другая информация, которую можно добавить/просмотреть здесь, включает ссылки, использование и применение, а также влияние этого вали.

История вали

При прямом или косвенном изменении вали изменения автоматически сохраняются в базе данных портала Requirements & Systems Portal. На вкладке истории вали отображается значение до, значение после и кто изменил значения. Requirements & Systems Portal фиксирует изменения, даже если измененный Vali не является прямой ссылкой на Vali.

Чтобы просмотреть историю изменений вали (см. рис Vali History), щелкните на имени вали (1) и откроется вкладка подробностей (2). Выберите иконку "История" (2) и ниже появится график, показывающий изменения по времени. В разделе "Последние изменения" (3) пользователь может найти таблицу, заполненную данными "Время", "Значение до", "Значение после" и "Причина".

История вали - на вкладке "История" отображается графическое и табличное представление изменения вали с течением времени.

Уведомления об изменениях

Чтобы получить уведомление об изменении определенного вали, вы можете подписаться на него, нажав на кнопку Subscribe в выпадающем списке кнопки Action (Действие) вали. Посмотрите на рисунок Subscribing to a Vali чтобы увидеть, как это делается.

Подписка на вали - При подписке на вали на вкладке "Уведомления" (символ колокольчика в правом верхнем углу) будут отображаться автоматические уведомления об изменении вали.

Вы увидите новое уведомление на колокольчике уведомлений в правом верхнем углу, когда кто-то изменил значение, на которое вы подписаны (4). Затем вы можете нажать на значок колокольчика, чтобы проверить уведомления.