Valisと計算
概略
- Valiの作成方法と、単一値から行列、データセットまで、適切なプロパティタイプを選択する方法を学びます。
- プロジェクトをまたいだValiの参照を含め、数学関数、論理関数、組み込み関数の使い方を紹介します。
- Valiの詳細や最小値・最大値の要件を管理し、変更履歴を確認して、変更通知を受け取る方法を解説します。
Valiは、計算やドキュメントで使用できる、ブロック、要件、解析の設計パラメーターです。Valiは数値を持ち、タイプ、単位、数式、説明、最小値/最大値の要件などの追加情報も含みます。
Valiの作成
ブロックのプロパティを表示しているときに、ページ右上の
ボタンをクリックすると、そのブロック内にValiを作成できます。開いた Create Property ウィンドウで、作成するプロパティのタイプを選択します。 Vali の場合は、ValiのName(任意の名前または Valitype の名前)を入力し、Formula and unit(必須)と Display Unit(任意)を設定します。 また、Add to Block フィールドで、このValiを追加するブロックを指定できます。
プロパティの作成時には、通常の Vali、Matrix、Textvali、Datevali、Dataset など、さまざまなタイプのValiを作成できます。
| タイプ | 説明 |
|---|---|
| Vali | 質量、コスト、密度など、単一の値のみを持つブロックのプロパティ。 |
| Matrix | 行列は、個々のValiを行と列に並べたものです。Matrix Valiは、モードごとの消費電力や軸ごとの慣性値など、ブロックのプロパティがモードなどによって異なる場合によく使用されます。 |
| Textvali | 文字列やテキストを格納するVali。 |
| Datevali | 日付情報を格納するVali。 |
| Dataset | データセットの値をインポートまたは追加してグラフを作成し、その値をほかの値の計算に使用できます。 |
数式の追加
Valiは、一般的な数式や定数、関数を使用して計算できます。数式には、ほかのValiを含めることもできます。
Formula and unit フィールドでは、現在のプロジェクトまたはほかのプロジェクトで利用可能なValiを参照できます。参照するには、フィールド内に $ を入力します。表示されるポップアップで、必要なValiを検索して選択します。

Valiの呼び出し – Requirements Portal内のどこでも、ドル記号 $ を使用すると、参照可能なオブジェクト(Vali、要件など)を表示するドロップダウンを開くことができます。
別のプロジェクトのValiを使用する場合は、ポップアップの一番下までスクロールして show other projects オプションを選択します。
一般的な数式のタイプ
次のように指定できます。
-
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()=「子の合計」:サブブロック内にある同じタイプのすべてのValiの合計 -
poc()=「子の積」:サブブロック内にある同じタイプのすべてのValiの積
数式では、次の論理関数も使用できます。
-
if(condition, formula_if_true, formula_if_false) -
max(formula1, formula2) -
min(formula1, formula2)
Requirements Portalの組み込み関数
-
soc():「sum of children」を表し、1つ下の階層のブロックにある同じタイプのすべての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つ下の階層のブロックにある同じタイプのValiの平均値を計算します -
poc():「product of children」を表し、1つ下の階層のブロックにある同じタイプのすべての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():子の最小値。サブブロック内にある同じタイプのすべてのValiの最小値を返します -
maxoc():子の最大値。サブブロック内にある同じタイプのすべてのValiの最大値を返します -
round():この関数は Pythonのround関数 の仕様に従い、値を10のマイナス乗の最も近い倍数に丸めます。 ndigits
数式の例:
-
$SolarPanel.width * $SolarPanel.length -
max(soc(), $SolarPanel.lowest_mass) -
if($SolarPanel.width*2 > $SolarPanel.length, 10, 5)
Valiの情報
Valiの名前をクリックすると、そのValiの詳細情報を確認できます。Valiの詳細ビューが開き、Info タブに情報が表示されます。

Valiの情報 – Valiをクリックすると、追加情報を含むビューが開きます。ここでは、さらにプロパティを設定したり、説明を追加したり、影響を定義したりできます。
このビューに表示されるValiの基本情報は次のとおりです。
-
ID – IDは、バックエンドで使用されるValiengineによって自動的に追加されるランダムな数値です。
-
Name – ここでは、Valiの名前を入力、編集できます。
-
Description – 説明フィールドには、Valiの説明を入力できます。また、以下に示すようにタスクの書式設定や編集も行えます。
マージンや単位の追加・変更、要件(最小値/最大値)の追加も可能です。要件(最小値/最大値)は、そのプロパティに設定する制限値です。
ここで追加・表示できるその他の情報には、参照、使用先と使用元、このValiの影響などがあります。
Valiの履歴
Valiが直接的または間接的に変更されると、その変更はRequirements Portalのデータベースに自動的に保存されます。ValiのHistoryタブには、変更前の値、変更後の値、値を変更したユーザーが表示されます。Requirements Portalは、変更されたValiが対象のValiから直接参照されていない場合でも、変更を記録します。
Valiの変更履歴を確認するには、Valiの名前をクリックし、Historyタブを選択します。このタブには、時間の経過に伴う変更を示すグラフが表示されます。グラフの下には、Time、Value Before、Value After、Reasonのデータが入力されたRecent Changesテーブルが表示されます。

Valiの履歴 – Historyタブには、時間の経過に伴うValiの変更がグラフと表で表示されます。
変更通知
特定のValiが変更されたときに通知を受け取るには、「アクション」列の3点ボタンをクリックし、表示されるメニューからAdd » Subscribe コマンドを選択して、そのValiを購読します。
通知の詳細については、通知ページを参照してください。
