Valis und Berechnungen

Valis sind Designparameter von Blöcken, Anforderungen oder Analysen, die in Berechnungen und in 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 (dieser kann beliebig sein oder ein Valitype-Name - 1), eine Formel und Einheit (verpflichtend - 2), eine Anzeigeeinheit (optional - 3), und klicken Sie auf „Create“ oder „Create & add New“ (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 Blöcken 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 Arten von Valis.

Beachten Sie, dass der Benutzer beim Erstellen einer Eigenschaft verschiedene Valis anlegen 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 Blöcke unterschiedliche Modi hat. Z. B. Leistungsaufnahme in verschiedenen Modi oder 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 mithilfe 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, dann öffnet sich ein kleines Dialogfeld mit darin enthaltenen Valis (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, Anforderungen usw.).

Falls der Benutzer Valis aus einem anderen Projekt verwenden möchte, kann er im Dialogfeld ganz nach unten 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 mit dem $ Zeichen verwenden: $car.speed+5

In Formeln verfügbare mathematische Operationen sind:

• +, -, *, /

• %(Modulo-Operation)

• ^

• sqrt()

• exp()

• log10(), ln(), log()

• sin(), cos(), tan()

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

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

• fabs(): gibt den Absolutwert zurück

• soc() = „Sum of children“: Summe aller Valis desselben Typs in Unterblöcken

• poc() = „Product of children“: Produkt aller Valis desselben Typs in Unterblöcken

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“ und summiert alle Valis desselben Typs in den Blöcken 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“ und berechnet den Durchschnittswert der Valis desselben Typs in den Blöcken eine Ebene darunter

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

• average_of_datasets() oder aod(): das Ergebnis des Vali ist der Durchschnitt für jeden Punkt der Datasets, die zu diesem Vali gehören. 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 Datasets, die zu diesem Vali gehören. 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 Minus- und Plus-Worst-Cases abzurufen)

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

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

• round(): Die integrierte Funktion round( ) folgt den Spezifikationen der Python's round function, bei der 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 zum Vali sehen, indem Sie auf seinen Namen klicken. Dadurch wird eine Detailansicht (1) geöffnet, und der Benutzer kann die Informationen (2) finden. Siehe Abbildung Vali Information für weitere Einblicke.

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 definieren.

Auf der Registerkarte „Information“ haben Benutzer verschiedene Möglichkeiten, Margen/Einheiten hinzuzufügen oder zu ändern sowie Anforderungen (Min./Max.) hinzuzufügen. Die Anforderungen (Min./Max.) sind die Grenzwerte, die Sie für die betreffende Eigenschaft haben. Wenn sich der Wert oder der Worst-Case erhöht oder verringert und die Werte die Grenzen Ihrer Anforderung überschreiten bzw. 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 aufsummierten Margen des untergeordneten Blocks ist. Weitere Informationen zu Margen finden Sie auf unserer Hilfeseite zu Margins.

ID: Die ID ist eine zufällige Nummer, die automatisch von der Valiengine hinzugefügt wird, die 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 außerdem wie unten gezeigt formatieren und bearbeiten.

Weitere Informationen, die hier hinzugefügt/angezeigt werden können, umfassen Referenzen, Using und Used by sowie die Auswirkungen 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. Die Registerkarte „History“ 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 Verlauf der Änderungen eines Vali anzuzeigen (siehe Abbildung Vali History), klicken Sie auf den Namen des Vali (1) und die Registerkarte „Details“ wird geöffnet (2). Wählen Sie das Symbol „History“ (2) und darunter finden Sie 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 - Auf der Registerkarte „History“ wird eine grafische und tabellarische Darstellung der Verä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 Aktionsschaltfläche des Vali auf „Subscribe“ klicken. In Abbildung Subscribing to a Vali sehen Sie, wie das funktioniert.

Ein Vali abonnieren – Wenn Sie ein Vali abonnieren, werden im Benachrichtigungs-Tab (Glockensymbol in der oberen rechten Ecke) automatisch Benachrichtigungen angezeigt, wenn sich das Vali ändert.

Sie sehen eine neue Benachrichtigung an der Glocke oben rechts, 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.