Valis i obliczenia

Vali to parametry projektowe bloków, wymagań lub analiz, które można wykorzystywać w obliczeniach i dokumentacji. Vali ma wartość liczbową i zawiera także dodatkowe informacje, takie jak typ, jednostka, formuła, opis oraz wymagania min./maks.

Tworzenie Vali

Vali można utworzyć w bloku, klikając najpierw symbol „+” w prawym dolnym rogu ekranu. Następnie należy uzupełnić nazwę (może to być dowolna nazwa lub nazwa Valitype - 1), formułę i jednostkę (wymagane - 2), jednostkę wyświetlania (opcjonalne - 3), a następnie kliknąć „Create” lub „Create & add New” (zob. rysunek Adding a Vali). Informacje o jednostkach i ich konwersji można znaleźć w sekcji Units and Automatic Unit Conversion.

Dodatkowo można zdecydować, do których bloków chcesz dodać to Vali (4).

Pro-tip: W polu Formula and Unit naciśnij „\”, aby wyświetlić listę możliwych typów obliczeń.

Dodawanie Vali — okno podręczne do dodawania różnych typów Vali.

Należy pamiętać, że podczas tworzenia właściwości użytkownik może utworzyć różne typy Vali, np. zwykłe Vali, Matrix, Text Vali, Datevali lub Dataset.

Type	Use-case
Vali	Właściwość bloku, która ma tylko jedną wartość, np. masa, koszt, gęstość itp.
Matrix	Macierz to grupa pojedynczych Vali uporządkowanych w wierszach i kolumnach. Matrix Vali jest powszechnie używane, gdy właściwość bloków ma różne tryby. Np. zużycie energii w różnych trybach, wartości bezwładności na różnych osiach.
Text Vali	Vali przechowujące ciągi znaków/tekst, np.
DateVali	Vali przechowujące informacje o dacie, np.
Dataset	Tutaj użytkownik może importować lub dodawać wartości zestawu danych, tworzyć wykres i używać tych wartości w obliczeniach innych wartości.

Dodawanie formuł

Vali można obliczać za pomocą formuły wykorzystującej typowe wyrażenia matematyczne albo przez dodawanie stałych lub funkcji. Formuła może również zawierać inne Vali.

W polu Formula and Unit użytkownik może odwoływać się do Vali dostępnych w projekcie lub także w innych projektach. Aby to zrobić, należy przejść do „Formula and Unit” i wpisać “$”, wtedy otworzy się małe okno dialogowe z Vali w środku (zob. rysunek Calling Valis). Użytkownicy mogą wpisywać słowa kluczowe, aby łatwo znaleźć Vali.

Wywoływanie Vali — w dowolnym miejscu Requirements & Systems Portal można użyć symbolu dolara „$”, aby otworzyć listę rozwijaną pokazującą wszystkie obiekty, do których można się odwołać (np. Vali, Requirements itp.).

Jeśli użytkownik chce użyć Vali z innego projektu, może przewinąć do końca okna dialogowego, aby wybrać opcję “show other projects”.

Typowe typy formuł

Możesz:

• użyć stałej wartości, takiej jak 42.7kg

• użyć formuły, takiej jak 5/(3+17.3*9)

• użyć innych Vali, używając znaku $ : $car.speed+5

Dostępne operacje matematyczne w formułach to:

• +, -, *, /

• %(operacja modulo)

• ^

• sqrt()

• exp()

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

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

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

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

• fabs(): zwraca wartość bezwzględną

• soc() = „Suma elementów podrzędnych”: suma wszystkich Vali tego samego typu w podblokach

• poc() = „Iloczyn elementów podrzędnych”: iloczyn wszystkich Vali tego samego typu w podblokach

W formułach można również używać następujących funkcji logicznych:

• if(condition, formula_if_true, formula_if_false)

• max(formula1, formula2)

• min(formula1, formula2)

Wbudowane funkcje Requirements & Systems Portal:

• soc(): oznacza „sumę elementów podrzędnych”, sumuje wszystkie Vali tego samego typu w blokach o jeden poziom niżej

• rssoc(): Oznacza „pierwiastek z sumy kwadratów elementów podrzędnych” sqrt(x1^2+x2^2+⋯+xn^2). Na przykład, jeśli masz trzy masy 2 kg, 5 kg i 6 kg, funkcja rssoc zwróci wynik 8.062257

• aoc(): oznacza „średnią elementów podrzędnych”, oblicza średnią wartość Vali tego samego typu w blokach o jeden poziom niżej

• poc(): oznacza „iloczyn elementów podrzędnych”, mnoży wszystkie Vali tego samego typu w blokach o jeden poziom niżej

• average_of_datasets() lub aod(): wynikiem Vali jest średnia dla każdego punktu zestawów danych należących do tego Vali. Jeśli istnieje tylko jeden zestaw danych, to ten zestaw danych jest wynikiem i jest używany w dalszych obliczeniach

• sum_of_datasets() lub sod(): wynikiem Vali jest suma dla każdego punktu zestawów danych należących do tego Vali. Jeśli istnieje tylko jeden zestaw danych, to ten zestaw danych jest wynikiem i jest używany w dalszych obliczeniach

• property($vali, property_name): Pobiera właściwość Vali. Możliwe wartości property_name to:

  • min

  • max (odpowiednio pobiera wymagania min. i maks.)

  • wc_minus

  • wc_plus (odpowiednio pobiera najgorszy przypadek ujemny i dodatni)

• minoc(): Minimum elementów podrzędnych. Zwraca minimalną wartość spośród wszystkich Vali tego samego typu w podblokach

• maxoc(): Maksimum elementów podrzędnych. Zwraca maksymalną wartość spośród wszystkich Vali tego samego typu w podblokach

• round(): Wbudowana funkcja round( ) działa zgodnie ze specyfikacją Python's round function, w której wartości są zaokrąglane do najbliższej wielokrotności 10 do potęgi minus ndigits

   

Przykłady formuł:

• $SolarPanel.width * $SolarPanel.length

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

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

Vali Information

Więcej informacji o Vali można zobaczyć, klikając jego nazwę. Otworzy to widok szczegółów (1), a użytkownik znajdzie tam informacje (2). Więcej szczegółów znajduje się na rysunku Vali Information .

Informacje o Vali — po kliknięciu Vali otworzy się okno z dodatkowymi informacjami. Tutaj można zdefiniować więcej właściwości, dodać opis i określić wpływy.

Na karcie informacji użytkownicy mają kilka możliwości dodawania/zmiany marginesów/jednostek, a także dodawania wymagań (min./maks.). Wymagania (min./maks.) to limity dla danej właściwości. Gdy wartość lub najgorszy przypadek wzrasta albo maleje i wartości przekraczają/spadają poniżej limitów wymagań, Requirements & Systems Portal wyświetla ostrzeżenie obok nazwy Vali. Więcej informacji znajduje się w sekcji Warnings.

Należy pamiętać, że całkowity margines prezentowany we właściwościach Vali jest marginesem bloku oraz całkowitą skumulowaną wartością marginesów bloków podrzędnych. Więcej informacji o marginesach można znaleźć na naszej stronie pomocy Margins.

ID: identyfikator ID to liczba losowa automatycznie dodawana przez Valiengine używany w backendzie. Możesz wpisać ID Vali w polu wyszukiwania Rest API, aby znaleźć dane Vali. Zapoznaj się z dokumentacją Rest API.

Name: tutaj można wprowadzić i edytować nazwę Vali.

Description: w polu opisu można wprowadzić opis Vali. Można również formatować i edytować zadania, jak pokazano poniżej.

Inne informacje, które można tutaj dodać/zobaczyć, obejmują References, Using i Used by, a także Impacts tego Vali.

Historia Vali

Gdy Vali zostanie zmienione bezpośrednio lub pośrednio, zmiany są automatycznie zapisywane w bazie danych Requirements & Systems Portal. Karta historii Vali pokazuje wartość przed zmianą, wartość po zmianie oraz kto zmienił wartości. Requirements & Systems Portal rejestruje zmiany nawet wtedy, gdy zmienione Vali nie jest bezpośrednio powiązane z danym Vali.

Aby zobaczyć historię zmian Vali (zob. rysunek Vali History), kliknij nazwę Vali (1), a otworzy się karta szczegółów (2). Wybierz ikonę „History” (2) , a poniżej pojawi się wykres pokazujący zmiany w czasie. W sekcji „Recent Changes” (3) użytkownik znajdzie tabelę zawierającą dane „Time”, „Value before”, „Value after” i „Reason”.

Historia Vali — na karcie History wyświetlana jest graficzna i tabelaryczna prezentacja zmian Vali w czasie.

Powiadomienia o zmianach

Aby otrzymywać powiadomienia, gdy określone Vali ulegnie zmianie, możesz je subskrybować, klikając Subscribe w menu rozwijanym przycisku Action danego Vali. Zobacz rysunek Subscribing to a Vali, aby sprawdzić, jak to zrobić.

Subskrybowanie Vali — po zasubskrybowaniu Vali automatyczne powiadomienia będą wyświetlane na karcie Notification (symbol dzwonka w prawym górnym rogu), gdy Vali ulegnie zmianie.

Nowe powiadomienie pojawi się na dzwonku powiadomień w prawym górnym rogu, gdy ktoś zmieni wartość, którą subskrybujesz (4). Następnie możesz kliknąć ikonę dzwonka, aby sprawdzić powiadomienia.