Valis と Calculations

Created: 1月 23, 2025 | Updated: 3月 12, 2026

Vali は、Blocks、Requirements、または Analyses の設計パラメーターで、計算やドキュメント作成に使用できます。Vali には数値があり、さらにタイプ、単位、数式、説明、最小/最大要件などの追加情報も含まれます。

Vali の作成

Block で Vali を作成するには、まず画面右下の「+」記号をクリックします。次に、名前（任意の名前、または Valitype 名 - 1）、数式と単位（必須 - 2）、表示単位（任意 - 3）を入力し、「Create」または「Create & add New」をクリックします（図 Adding a Vali を参照）。単位とその変換については、Units and Automatic Unit Conversion を参照してください。

さらに、この Vali を追加する Blocks を選択することもできます（4）。

Pro-tip：Formula and Unit フィールドで「\」を入力すると、使用可能な計算タイプの一覧が表示されます。

プロパティの作成時に、ユーザーは通常の Vali、Matrix、Text Vali、DateVali、Dataset など、さまざまな Vali を作成できます。

Type	Use-case
Vali	単一の値のみを持つ Block のプロパティです。例：mass、cost、density など。
Matrix	Matrix は、行と列に並べられた個々の Vali のグループです。Matrix Vali は、Blocks のプロパティに複数のモードがある場合によく使用されます。例：異なるモードでの Powerconsumption、異なる軸での inertia 値。
Text Vali	文字列/テキストを保存する Vali。例：
DateVali	日付情報を保存する Vali。例：
Dataset	ここでは、ユーザーはデータセット値をインポートまたは追加し、グラフを作成し、その値を他の値の計算に使用できます。

数式の追加

Vali は、一般的な数式表現、定数、または関数を使った数式で計算できます。数式には他の Vali を含めることもできます。

Formula and Unit フィールド内では、ユーザーはプロジェクト内、または他のプロジェクト内で利用可能な Vali を参照できます。そのためには、「Formula and Unit」に移動して “$” を入力します。すると、Vali を含む小さなダイアログボックスが開きます（図 Calling Valis を参照）。ユーザーはキーワードを入力して、目的の Vali を簡単に見つけることができます。

別のプロジェクトの Valis を使用したい場合は、ダイアログボックスの一番下までスクロールして、“show other projects” オプションを選択します。

よく使う Vali を保存していつでも計算で呼び出せるように、独自の「Constants」プロジェクトを作成してください。
数式エディターは、数式を見やすく表示するために Latex 構文を使用します。たとえば、sqrt を入力するか、Ctrl+S を押すと、自動的に平方根記号に変換されます。同様に、^ はべき乗などに使用できます。また、青いハイライトと四角いボックスが表示されるため、長い数式も入力しやすくなっています。

エディターには、かっこの自動補完機能もあります。

一般的な数式タイプ

次のいずれかを使用できます。

固定値を使用する（例： 42.7kg
数式を使用する（例： 5/(3+17.3*9)
他の Vali を使用する。使用する記号は $ です： $car.speed+5

数式で使用可能な数学演算は次のとおりです。

+、 -、 *、 /
%（剰余演算）
^
sqrt()
exp()
log10()、 ln()、 log()
sin()、 cos()、 tan()
asin()、 acos()、 atan()
sinh()、 cosh()、 tanh()
fabs()：絶対値を返します
soc() = 「子要素の合計」：サブ Blocks 内の同じタイプのすべての Vali の合計
poc() = 「子要素の積」：サブ Blocks 内の同じタイプのすべての Vali の積

数式では、次の論理関数も使用できます。

if(condition, formula_if_true, formula_if_false)
max(formula1, formula2)
min(formula1, formula2)

Requirements & Systems Portal の組み込み関数：

soc()： "sum of children" を表し、1 階層下の Blocks にある同じタイプのすべての Vali を合計します
rssoc(): “root sum squared of children” sqrt(x1^2+x2^2+⋯+xn^2) を表します。たとえば、2kg、5kg、6kg の 3 つの質量がある場合、rssoc 関数の結果は 8.062257 になります
aoc()： "average of children" を表し、1 階層下の Blocks にある同じタイプの Vali の平均値を計算します
poc()： "product of children" を表し、1 階層下の Blocks にある同じタイプのすべての Vali を掛け合わせます
average_of_datasets() または aod()：その Vali の結果は、その Vali に属するデータセットの各点における平均値になります。データセットが 1 つしかない場合は、そのデータセットが結果となり、以降の計算に使用されます
sum_of_datasets() または sod()：その Vali の結果は、その Vali に属するデータセットの各点における合計値になります。データセットが 1 つしかない場合は、そのデータセットが結果となり、以降の計算に使用されます
property($vali, property_name)：Vali のプロパティを取得します。property_name に指定できるものは次のとおりです。
- min
- max（それぞれ最小要件と最大要件を取得）
- wc_minus
- wc_plus（それぞれマイナス側とプラス側のワーストケースを取得）
minoc()：子要素の最小値。サブ Blocks 内の同じタイプのすべての Vali の最小値を返します
maxoc()：子要素の最大値。サブ Blocks 内の同じタイプのすべての Vali の最大値を返します
round()：組み込みの round( ) 関数は、Python's round function の仕様に従います。値は 10 のマイナス ndigits

乗の最も近い倍数に丸められます

数式の例：

$SolarPanel.width * $SolarPanel.length
max(soc(), $SolarPanel.lowest_mass)
if($SolarPanel.width*2 > $SolarPanel.length, 10, 5)

Vali Information

Vali の名前をクリックすると、その Vali に関する詳細情報を確認できます。これにより詳細ビュー (1) が開き、ユーザーは情報 (2) を確認できます。詳しくは図 Vali Information を参照してください。

情報タブでは、ユーザーはマージン/単位の追加・変更や、要件（min/max）の追加を行えます。要件（min/max）は、その特定のプロパティに対する制限値です。値またはワーストケースが増減し、その値が要件の制限を超えたり下回ったりすると、Requirements & Systems Portal は Vali 名の横に警告を表示します。詳細は Warnings セクションを参照してください。

Vali のプロパティに表示される total margin は、Block のマージンと子 Block の累積マージンの合計であることに注意してください。Margins の詳細については、Margins のヘルプページを参照してください。

ID： ID は、バックエンドで使用される Valiengine によってランダムに自動追加される番号です。Vali を見つけるには、Rest API の検索フィールドに Vali の ID を入力できます。詳細は Rest API のドキュメントを参照してください。

Name：ここでは Vali の名前を入力および編集できます。

Description：description フィールドでは、Vali の説明を入力できます。以下に示すように、タスクの書式設定や編集も可能です。

ここで追加/表示できるその他の情報には、References、Using、Used by、およびこの Vali の Impacts があります。

Valis の履歴

Vali が直接または間接的に変更されると、その変更は自動的に Requirements & Systems Portal のデータベースに保存されます。Vali の履歴タブには、変更前の値、変更後の値、および誰が値を変更したかが表示されます。Requirements & Systems Portal は、変更された Vali がその Vali に直接参照されていない場合でも変更を記録します。

Vali の変更履歴を確認するには（図 Vali History を参照）、Vali の名前 (1) をクリックして詳細タブを開きます (2)。「History」アイコン (2) を選択すると、その下に時間に対する変化を示すグラフが表示されます。「Recent Changes」(3) では、「Time」「Value before」「Value after」「Reason」のデータが入った表を確認できます。