Valis と Calculations

Updated: 3月 12, 2026

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

Vali の作成

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

さらに、この Vali をどの Block に追加するかを指定できます（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 は、Block のプロパティに複数のモードがある場合によく使用されます。たとえば、異なるモードでの power consumption や、異なる軸での inertia 値などです。
Text Vali	文字列/テキストを格納する Vali です。例:
DateVali	日付情報を格納する Vali です。例:
Dataset	ここでは、ユーザーは dataset の値をインポートまたは追加し、グラフを作成し、その値を他の値の計算に使用できます。

式の追加

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

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

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

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

エディタには括弧の自動補完機能もあります。

一般的な数式の種類

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

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

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

+, -, *, /
%（剰余演算）
^
sqrt()
exp()
log10(), ln(), log()
sin(), , tan()
asin(), acos(), atan()
sinh(), cosh(), tanh()
fabs(): 絶対値を返します
soc() = 「Sum of children」: 下位 Block 内にある同じタイプのすべての Vali の合計
poc() = 「Product of children」: 下位 Block 内にある同じタイプのすべての Vali の積

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

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

Requirements & Systems Portal 組み込み関数:

soc(): 「sum of children」を意味し、1 階層下の Block 内にある同じタイプのすべての Vali を合計します
rssoc(): 「root sum squared of children」を意味し、sqrt(x1^2+x2^2+⋯+xn^2) を表します。たとえば、2kg、5kg、6kg の 3 つの mass がある場合、rssoc 関数の結果は 8.062257 になります
aoc(): 「average of children」を意味し、1 階層下の Block 内にある同じタイプの Vali の平均値を計算します
poc(): 「product of children」を意味し、1 階層下の Block 内にある同じタイプのすべての Vali を掛け合わせます
average_of_datasets() または aod(): Vali の結果は、その Vali に属する dataset の各点における平均値になります。dataset が 1 つしかない場合は、その dataset 自体が結果となり、後続の計算に使用されます
sum_of_datasets() または sod(): Vali の結果は、その Vali に属する dataset の各点における合計値になります。dataset が 1 つしかない場合は、その dataset 自体が結果となり、後続の計算に使用されます
property($vali, property_name): Vali のプロパティを取得します。property_name に指定できるものは次のとおりです:
- min
- max（それぞれ最小要件と最大要件を取得）
- wc_minus
- wc_plus（それぞれマイナス側とプラス側の worst case を取得）
minoc(): children の最小値。同じタイプのすべての Vali のうち、sub Block 内の最小値を返します
maxoc(): children の最大値。同じタイプのすべての Vali のうち、sub Block 内の最大値を返します
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）は、その特定のプロパティに対して設定する制限値です。値または worst-case が増減し、その値が要件の制限を超えた、または下回った場合、Requirements & Systems Portal は Vali 名の横に警告を表示します。詳細は Warnings セクションを参照してください。

Vali プロパティに表示される total margin は、その Block の margin と子 Block の累積 total margin を合わせたものです。Margin の詳細については、ヘルプページ Margins を参照してください。

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

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

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

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

Vali の履歴

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

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