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, najpierw klikając symbol „+” w prawym dolnym rogu ekranu. Następnie wpisz nazwę (może to być dowolna nazwa lub nazwa Valitype - 1), Formułę i Jednostkę (wymagane - 2), Jednostkę wyświetlania (opcjonalnie - 3), a następnie kliknij „Create” lub „Create & add New” (zob. rysunek Adding a Vali). Przewodnik dotyczący jednostek i ich konwersji znajduje się w sekcji Units and Automatic Unit Conversion.

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

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

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

Pamiętaj, ż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żywany, gdy właściwość bloków ma różne tryby. Np. pobór mocy w różnych trybach, wartości bezwładności na różnych osiach.
Text Vali	Vali przechowujący ciągi znaków/tekst, np.
DateVali	Vali przechowujący informacje o dacie, np.
Dataset	Tutaj użytkownik może importować lub dodawać wartości zbioru 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 zarówno w obrębie projektu, jak i w innych projektach. Aby to zrobić, należy przejść do „Formula and Unit” i wpisać “$”, a 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 i wybrać opcję “show other projects”.

Typowe rodzaje formuł

Możesz:

• użyć wartości stałej, 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

Operacje matematyczne dostępne 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 także 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 daje 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 zbiorów danych należących do tego Vali. Jeśli istnieje tylko jeden zbiór danych, ten zbiór danych jest wynikiem i jest używany w dalszych obliczeniach

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

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

  • min

  • max (aby uzyskać odpowiednio wymagania min. i maks.)

  • wc_minus

  • wc_plus (aby uzyskać odpowiednio ujemne i dodatnie przypadki worst case)

• 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ę. Spowoduje to otwarcie widoku 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 definiować więcej właściwości, dodać opis i zdefiniować wpływy.

W zakładce 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 worst-case wzrasta albo maleje i jeśli wartości przekraczają limity wymagań lub spadają poniżej nich, Requirements & Systems Portal wyświetla ostrzeżenie obok nazwy Vali. Więcej informacji znajduje się w sekcji Warnings.

Pamiętaj, że całkowity margines prezentowany we właściwościach Vali jest marginesem bloku oraz łącznym skumulowanym marginesem bloku podrzędnego. Więcej informacji o marginesach znajdziesz na naszej stronie pomocy dotyczącej Margins.

ID: identyfikator ID to losowy numer, automatycznie dodawany przez Valiengine, który jest używany w backendzie. Możesz wpisać ID Vali w polu wyszukiwania Rest API, aby znaleźć to Vali. Więcej informacji znajdziesz w dokumentacji Rest API.

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

Description: w polu opisu można wprowadzić opis Vali. Można także 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. Zakładka 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ę zakładka szczegółów (2). Wybierz ikonę „History” (2) , a poniżej znajdziesz 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 — w zakładce History pokazana jest graficzna i tabelaryczna reprezentacja 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 Powiadomienia (symbol dzwonka w prawym górnym rogu), gdy Vali ulegnie zmianie.

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