バリスと計算

バリとは、ブロック、要件、または解析の設計パラメータのことで、計算や文書化で使用することができます。値には数値があり、タイプ、単位、式、説明、最小/最大要件などの追加情報も含まれます。

バリの作成

まず、画面右下の「+」マークをクリックして、ブロック内にヴァリスを作成することができます。次に、名前（任意の名前またはバリスタ名 - 1）、計算式と単位（必須 - 2）、表示単位（任意 - 3）を入力し、「作成」または「新規作成と追加」をクリックします（図参照）。 Adding a Vali).単位とその変換については、単位と自動単位変換を参照してください。

さらに、どのブロックにこのバリを追加するかを決めることができます(4)。

Pro-tip:FormulaとUnitフィールドで"˶"を押すと、可能な計算タイプのリストが表示されます。

Valiの追加 - 異なるタイプのValiを追加するためのポップアップウィンドウ。

プロパティを作成している間、ユーザーは、通常のVali、Matrix、Text Vali、Datevali、Datasetなどの異なるValiを作成できることに注意してください。

Type	Use-case
バリ	例えば、質量、コスト、密度など。
マトリックス	行列は、行と列に並べられた個々のバリのグループである。マトリックス・バリは、ブロックのプロパティに異なるモードがある場合に一般的に使用されます。例：異なるモードでの消費電力、異なる軸での慣性値など。
テキスト・ヴァリ	文字列やテキストを保存するヴァリ、
日付ヴァリ	日付情報を格納するバリ、
データセット	ここで、ユーザーはデータセットの値をインポートまたは追加し、グラフを作成し、他の値の計算にその値を使用することができます。

計算式の追加

Valiは、一般的な数式を使用したり、定数や関数を追加して計算することができます。計算式には他のヴァリを含めることもできます。

ユーザーは、"Formula and Unit "フィールドで、プロジェクト内または他のプロジェクトで利用可能なバリを参照することができます。これを行うには、"Formula and Unit"（数式と単位）に移動し、以下のように入力します。 “$”, と入力すると、小さなダイアログ・ボックスが開き、その中にヴァリスが表示されます（図 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()子ブ ロ ッ ク の和」 ： 1 階層下のブ ロ ッ ク 内の同 じ 型のすべてのバ リ を合計 し ます。

• rssoc():sqrt(x1^2+x2^2+⋯+xn^2)は "root sum squared of children "の略です．例えば、2kg、5kg、6kgの3つの質量がある場合、rssoc関数を使うと8.062257となります。

• aoc(): は "average of children "の略で，1つ下の階層にある同じ種類のヴァリスの平均値を計算します。

• poc(): は "product of children "の略で、1つ下の階層にあるブロックの同じ種類のValisをすべて掛け合わせます。

• average_of_datasets()または aod()そのヴァリの結果は、そのヴァリに属するデータセットの各点の平均である。データセットが一つしかない場合は、そのデータセットが結果となり、それ以降の計算に使われる

• sum_of_datasets()または sod()Vali の結果は，その Vali に属するデータセットの各点の合計である．データセットが一つしかない場合は、そのデータセットが結果となり、以降の計算に使われる。

• property($vali, property_name):ヴァリのプロパティを取得する。property_nameの可能性は以下の通り：

  • min

  • max（それぞれ最小と最大の要件を取得する）

  • wc_minus

  • wc_plus（それぞれワーストケースのマイナスとプラスを求める）

• minoc():子ブロックの最小値.サブブロック内の同じ型を持つ全てのバリの最小値を返す。

• maxoc():子ブロックの最大値。サブブロック内の同じ型を持つ全てのバリの最大値を返す。

• round():組み込みの round( )関数は、Python の round 関数の仕様に従います。 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)は、特定のプロパティに対する制限です。値またはワーストケースが増減し、その値が要件の制限を超えたり下回ったりすると、Requirements & Systems Portal は、Vali の名前の横に警告を表示します。詳細については、 「警告」 のセ ク シ ョ ン を参照 し て く だ さ い。

なお、Vali プロパティに表示されるマージンの合計は、ブロックのマージンと、子ブロックのマージンの累積の合計です。余白に関す る 詳 し い情報は、 「余白」 のヘルプページを参照 し て く だ さ い。

ID: IDは、バックエンドで使用されるValiengineによって自動的に追加されるランダムな数字です。Vali を見つけるために、Rest API の検索フィールドに Vali の ID を入力することができます。Rest APIドキュメントを参照してください。

Name: ここでヴァリの名前を入力し、編集することができます。

Description説明フィールドにはヴァリの説明を入力できる。下記のようにタスクのフォーマットと編集もできます。

ここで追加・閲覧できる他の情報には、参考文献、使用者、影響などがあります。

ヴァリの履歴

ある Vali が直接または間接的に変更された場合、その変更は自動的に Requirements & Systems Portal のデータベースに保存されます。ヴァリの履歴タブには、変更前の値、変更後の値、および変更者が表示されます。要件 & システム ポータルは、変更された Vali がその Vali に直接参照されていない場合でも、変更内容を取得します。

Vali の変更履歴を表示するには（図 Vali Historyを参照)、Vali の名前をクリックします。 (1)をクリックすると、詳細タブが開きます。 (2).アイコンの "履歴 "を選択する。 (2) アイコンの "履歴 "を選択し、その下に時間に関する変化を示すグラフが表示されます。最近の変更" (3)には、「時間」、「変更前の値」、「変更後の値」、「理由」のデータで埋め尽くされた表が表示されます。

ヴァリ履歴 - 履歴タブでは、ヴァリの経時変化をグラフと表で表示します。

変更の通知

特定のValiが変更されたときに通知を受け取るには、ValiのActionボタンのドロップダウンにあるSubscribeをクリックします。図 Subscribing to a Valiをご覧ください。

ヴァリの購読 - ヴァリを購読すると、ヴァリが変更された時、通知タブ（右上のベルマーク）に自動通知が表示されます。

あなたが購読している値が変更されると、右上の通知ベルに新しい通知が表示されます。 (4).その後、ベルのアイコンをクリックして通知を確認することができます。