Valis und Berechnungen

Valis sind Entwurfsparameter von Blocks, Requirements oder Analyses, die in Berechnungen und der Dokumentation verwendet werden können. Ein Vali hat einen numerischen Wert und enthält außerdem zusätzliche Informationen wie Typ, Einheit, Formel, Beschreibung sowie Min-/Max-Anforderungen.

Valis erstellen

Sie können Valis in einem Block erstellen, indem Sie zunächst auf das „+“-Symbol in der unteren rechten Ecke des Bildschirms klicken. Fahren Sie dann fort, indem Sie einen Namen eingeben (dies kann ein beliebiger Name oder ein Valitype-Name - 1 sein), eine Formel und Einheit (verpflichtend - 2), eine Anzeigeeinheit (optional - 3) ausfüllen und auf „Create“ oder „Create & add New“ klicken (siehe Abbildung Adding a Vali). Eine Anleitung zu Einheiten und deren Umrechnung finden Sie unter Units and Automatic Unit Conversion.

Zusätzlich können Sie festlegen, zu welchen Blocks Sie dieses Vali hinzufügen möchten (4).

Pro-tip: Geben Sie im Feld „Formula and Unit“ „\“ ein, um eine Liste möglicher Berechnungstypen zu erhalten.

Vali hinzufügen - Pop-up-Fenster zum Hinzufügen verschiedener Vali-Typen.

Beachten Sie, dass der Benutzer beim Erstellen einer Eigenschaft verschiedene Valis erstellen kann, z. B. ein normales Vali, eine Matrix, ein Text Vali, ein DateVali oder ein Dataset.

Type	Use-case
Vali	Eigenschaft des Blocks, die nur einen einzelnen Wert hat, z. B. Masse, Kosten, Dichte usw..
Matrix	Eine Matrix ist eine Gruppe einzelner Valis, die in Zeilen und Spalten angeordnet sind. Ein Matrix-Vali wird üblicherweise verwendet, wenn die Eigenschaft der Blocks unterschiedliche Modi hat. Z. B. Leistungsaufnahme in verschiedenen Modi, Trägheitswerte auf unterschiedlichen Achsen.
Text Vali	Ein Vali, das Zeichenfolgen/Text speichert, z. B.
DateVali	Ein Vali, das Datumsinformationen speichert, z. B.
Dataset	Hier kann der Benutzer die Dataset-Werte importieren oder hinzufügen, ein Diagramm erstellen und deren Werte in der Berechnung anderer Werte verwenden.

Formeln hinzufügen

Ein Vali kann mit einer Formel unter Verwendung gängiger mathematischer Ausdrücke oder durch Hinzufügen von Konstanten oder Funktionen berechnet werden. Eine Formel kann auch andere Valis enthalten.

Im Feld „Formula and Unit“ kann der Benutzer auf Valis verweisen, die entweder innerhalb des Projekts oder auch in anderen Projekten verfügbar sind. Dazu kann er zu „Formula and Unit“ gehen und “$” eingeben, woraufhin sich ein kleines Dialogfeld mit enthaltenen Valis öffnet (siehe Abbildung Calling Valis). Benutzer können Schlüsselwörter eingeben, um das Vali leicht zu finden.

Valis aufrufen - Überall im Requirements & Systems Portal können Sie das Dollarzeichen „$“ verwenden, um ein Dropdown zu öffnen, das alle referenzierbaren Objekte anzeigt (z. B. Valis, Requirements usw.).

Falls der Benutzer Valis aus einem anderen Projekt verwenden möchte, kann er bis zum Ende des Dialogfelds scrollen, um die Option “show other projects” auszuwählen.

Gängige Formeltypen

Sie können entweder

• einen festen Wert verwenden, wie z. B. 42.7kg

• eine Formel verwenden, wie z. B. 5/(3+17.3*9)

• andere Valis verwenden, mit dem Zeichen $ : $car.speed+5

In Formeln verfügbare mathematische Operationen sind:

• +, -, *, /

• %(Modulo-Operation)

• ^

• sqrt()

• exp()

• log10(), ln(), , cos(), tan()

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

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

• fabs(): gibt den Absolutwert zurück

• soc() = „Summe der untergeordneten Elemente“: Summe aller Valis desselben Typs in untergeordneten Blocks

• poc() = „Produkt der untergeordneten Elemente“: Produkt aller Valis desselben Typs in untergeordneten Blocks

Sie können in Formeln auch die folgenden logischen Funktionen verwenden:

• if(condition, formula_if_true, formula_if_false)

• max(formula1, formula2)

• min(formula1, formula2)

In Requirements & Systems Portal integrierte Funktionen:

• soc(): steht für „sum of children“, summiert alle Valis desselben Typs in den Blocks eine Ebene darunter

• rssoc(): steht für „root sum squared of children“ sqrt(x1^2+x2^2+⋯+xn^2). Wenn Sie beispielsweise drei Massen von 2 kg, 5 kg und 6 kg haben, liefert die Funktion rssoc das Ergebnis 8.062257

• aoc(): steht für „average of children“, berechnet den Durchschnittswert der Valis desselben Typs in den Blocks eine Ebene darunter

• poc(): steht für „product of children“, multipliziert alle Valis desselben Typs in den Blocks eine Ebene darunter

• average_of_datasets() oder aod(): Das Ergebnis des Vali ist der Durchschnitt für jeden Punkt der zu diesem Vali gehörenden Datasets. Wenn es nur ein Dataset gibt, ist dieses Dataset das Ergebnis und wird in weiteren Berechnungen verwendet

• sum_of_datasets() oder sod(): Das Ergebnis des Vali ist die Summe für jeden Punkt der zu diesem Vali gehörenden Datasets. Wenn es nur ein Dataset gibt, ist dieses Dataset das Ergebnis und wird in weiteren Berechnungen verwendet

• property($vali, property_name): Eine Eigenschaft eines Vali abrufen. Mögliche Werte für property_name sind:

  • min

  • max (um jeweils die Min- und Max-Anforderungen abzurufen)

  • wc_minus

  • wc_plus (um jeweils die negativen und positiven Worst Cases abzurufen)

• minoc(): Minimum der untergeordneten Elemente. Gibt den kleinsten Wert aller Valis mit demselben Typ in den untergeordneten Blocks zurück

• maxoc(): Maximum der untergeordneten Elemente. Gibt den größten Wert aller Valis mit demselben Typ in den untergeordneten Blocks zurück

• round(): Die integrierte Funktion round( )  folgt den Spezifikationen der Python's round function, bei der die Werte auf das nächstgelegene Vielfache von 10 hoch minus ndigits

    gerundet werden

Beispiele für Formeln:

• $SolarPanel.width * $SolarPanel.length

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

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

Vali Information

Sie können weitere Informationen über das Vali sehen, indem Sie auf seinen Namen klicken. Dadurch wird eine Detailansicht geöffnet (1) und der Benutzer kann die Informationen (2) finden. Weitere Einblicke finden Sie in Abbildung Vali Information .

Vali-Informationen - Durch Klicken auf ein Vali öffnet sich ein Fenster mit zusätzlichen Informationen. Hier können Sie weitere Eigenschaften definieren, eine Beschreibung hinzufügen und Auswirkungen festlegen.

Innerhalb des Informationstabs haben Benutzer mehrere Möglichkeiten, Margins/Einheiten hinzuzufügen bzw. zu ändern und auch die Anforderungen (min/max) hinzuzufügen. Die Anforderungen (min/max) sind die Grenzwerte, die Sie für die jeweilige Eigenschaft haben. Wenn sich der Wert oder der Worst Case erhöht oder verringert und die Werte die Grenzen Ihrer Anforderung überschreiten/unterschreiten, gibt Requirements & Systems Portal neben dem Namen des Vali eine Warnung aus. Weitere Informationen finden Sie im Abschnitt Warnings.

Beachten Sie, dass die in den Vali-Eigenschaften dargestellte Gesamtmarge die Marge des Blocks und die insgesamt akkumulierten Margen des untergeordneten Blocks ist. Weitere Informationen zu Margins finden Sie auf unserer Hilfeseite zu Margins.

ID: Die ID ist eine zufällige Nummer, die von der Valiengine automatisch hinzugefügt wird und im Backend verwendet wird. Sie können die ID eines Vali in das Suchfeld der Rest API eingeben, um das Vali zu finden. Bitte beachten Sie die Dokumentation zur Rest API.

Name: Hier können Sie den Namen des Vali eingeben und bearbeiten.

Description: Im Beschreibungsfeld können Sie eine Beschreibung des Vali eingeben. Sie können Aufgaben auch wie unten gezeigt formatieren und bearbeiten.

Weitere Informationen, die hier hinzugefügt/angezeigt werden können, umfassen References, Using und Used by sowie die Impacts dieses Vali.

Verlauf von Valis

Wenn ein Vali direkt oder indirekt geändert wird, werden die Änderungen automatisch in der Datenbank von Requirements & Systems Portal gespeichert. Der Verlaufstab des Vali zeigt den Wert davor, den Wert danach und wer die Werte geändert hat. Requirements & Systems Portal erfasst die Änderungen auch dann, wenn das geänderte Vali nicht direkt auf das Vali referenziert.

Um den Änderungsverlauf eines Vali zu sehen (siehe Abbildung Vali History), klicken Sie auf den Namen des Vali (1) und der Detailtab öffnet sich (2). Wählen Sie das Symbol „History“ (2) und darunter finden Sie dann das Diagramm, das die Änderungen im Zeitverlauf zeigt. Unter „Recent Changes“ (3) findet der Benutzer eine Tabelle mit den Daten „Time“, „Value before“, „Value after“ und „Reason“.

Vali-Verlauf - Im Tab „History“ wird eine grafische und tabellarische Darstellung der Änderung eines Vali im Zeitverlauf angezeigt.

Benachrichtigungen bei Änderungen

Um eine Benachrichtigung zu erhalten, wenn sich ein bestimmtes Vali ändert, können Sie es abonnieren, indem Sie im Dropdown der Schaltfläche „Action“ des Vali auf „Subscribe“ klicken. In Abbildung Subscribing to a Vali sehen Sie, wie das funktioniert.

Ein Vali abonnieren - Durch das Abonnieren eines Vali werden automatische Benachrichtigungen im Notification-Tab (Glockensymbol in der oberen rechten Ecke) angezeigt, wenn sich das Vali ändert.

Sie sehen eine neue Benachrichtigung an der Benachrichtigungsglocke in der oberen rechten Ecke, wenn jemand einen Wert geändert hat, den Sie abonniert haben (4). Anschließend können Sie auf das Glockensymbol klicken, um die Benachrichtigungen zu prüfen.