Jednostki i automatyczne konwersje jednostek

Konwersja jednostek umożliwia podłączenie jednostki fizycznej do Vali. Dla każdego obliczenia z tym Vali, niezbędna konwersja zostanie wykonana automatycznie na zapleczu. W tym celu wykorzystywana jest biblioteka Pint. Rysunek Unit Conversion pokazuje, jak 50 kg jest automatycznie konwertowane na 110,23 funta (lbs), ponieważ pole Value+Unit zawiera 50 kg, ale Display Unit to "lbs". Automatycznie stosowane są również przedrostki i przyrostki, czego przykładem jest konwersja jednostki wyświetlania wartości masy z "kg" na "g" w filmie. Należy pamiętać, że jednostki powinny się zgadzać, a wszelkie niezgodności są sygnalizowane wykrzyknikiem na nazwie Vali przez Portal wymagań i systemów.

Ponadto można określić formułę $vali3 = $vali1 + $vali2 przy użyciu $vali1 = 10 meter i vali2 = 100 cm. Jeśli ustawisz jednostkę wyświetlania wartości vali3 na yd (jard), wynik zostanie automatycznie obliczony i przeliczony: 12.030 yd. Jeśli nie określisz jednostki wyświetlania dla vali3, jednostka zostanie obliczona automatycznie (w tym przypadku będzie to metr lub centymetr). Jednostka każdego vali jest taka sama dla wszystkich użytkowników przeglądających vali. Wszystkie obsługiwane jednostki i stałe są wymienione w bibliotece Pint.

Obsługa jednostek w Valis i formułach

Tworzenie wartości

Podczas tworzenia nowej Vali (wartości liczbowej lub formuły) istnieją dwa ważne pola właściwości:

• Formuła i Jednostka (obowiązkowe)

  • W przypadku wartości liczbowych (np. 50 kg) pole to musi zawierać wartość i jednostkę

  • W przypadku formuł (np. $wheel1.mass+$wheel2.mass) jednostka wynika z obliczeń.

• Jednostka wyświetlania (opcjonalnie - jeśli puste, jednostka wyświetlania będzie oparta na jednostkach z pola Formuła i jednostka)

Poniższa tabela przedstawia podsumowanie oczekiwanego zachowania podczas tworzenia Vali, w zależności od różnych opcji tworzenia:

Zmiana jednostek

Pole jednostki wyświetlania

Zmiana pola Jednostka wyświetlania jest zawsze możliwa, o ile Jednostka wyświetlania jest zgodna z prawidłową konwersją z używanej (lub obliczonej za pomocą formuł) jednostki z pola Formuła i jednostka. Jeśli wystąpi niezgodność wymiaru, Portal wymagań i systemów wskaże to wykrzyknikiem i komunikatem w Vali.

Gdy jednostka wyświetlania zostanie zmieniona na coś, co jest prawidłową konwersją (np. s na ms lub m/s na km/s), wartość Vali zostanie ponownie obliczona i wyświetlona w odpowiedniej jednostce po konwersji, np. 100 s = 100 000 ms.

Pole formuły i jednostki

Jeśli Vali jest tylko wartością liczbową (nie formułą), można zmienić jednostkę, np. z m na s. Vali stanie się po prostu 100 s zamiast 100 m. Jeśli jednak po zmianie jednostka wyświetlania nie pasuje wymiarowo do nowej jednostki, Portal wymagań i systemów wskaże niedopasowanie wymiarów i należy dostosować jednostkę wyświetlania.

Formuły

Jeśli Vali ma formułę, formuła decyduje o oczekiwanej jednostce w zależności od użytych zmiennych. Możesz wybrać wyświetlanie wartości w dowolnej jednostce (za pomocą pola Jednostka wyświetlania), która jest prawidłową konwersją z jednostki formuły. Zmiana jednostki wyświetlania z m/s na km/s spowoduje odpowiednie wyświetlenie wartości. Możliwa jest zmiana jednostki wyświetlania z m/s na m, ale Portal wymagań i systemów wskaże problem z wymiarem jednostki.

Wartości bezwymiarowe

Wartości bezwymiarowe mogą być używane w mnożeniu i dzieleniu, ale nie w dodawaniu i odejmowaniu z wartościami, które mają jednostkę, ponieważ jednostki nie będą zgodne. Wszystkie wartości, które mają jednostkę, powinny być zapisywane jako wartości z jednostką (w polu Formuła i jednostka) i używane jako parametry w formułach (co oznacza, że nie należy używać "magicznych" liczb).

Jednostki, które nie są rozpoznawane ("jednostki niezdefiniowane") są również uważane za bezwymiarowe.

Jednostki niezdefiniowane

Dostępne jest osobne ustawienie umożliwiające korzystanie z niezdefiniowanych jednostek. Jeśli opcja ta jest włączona (ustawienie domyślne), możliwe jest dodanie jednostek, które nie są obsługiwane, ale zostanie wyświetlone ostrzeżenie. Jeśli opcja ta jest wyłączona, nie jest możliwe nadanie Vali niezdefiniowanej jednostki.

Zmiana jednostek Valitype

Jednostkę Valitype można zmienić tylko na inną jednostkę, która ma takie same wymiary jak oryginalna jednostka. Ta zmiana nie wpłynie na żadne istniejące Valis tego typu, ale nowe Valis utworzone z tym Valitype będą miały nową jednostkę.

Wymagania i najgorsze przypadki

Wymagania (wartości minimalne/maksymalne) i najgorsze przypadki są zawsze wyświetlane w tej samej jednostce co jednostka Vali. Jeśli jednostka zostanie zmieniona, wymagania i najgorsze przypadki zostaną również przeliczone, aby odpowiadały wybranej jednostce.

Obsługiwane jednostki i stałe

Portal wymagań i systemów obsługuje wszystkie domyślne jednostki i konwersje zdefiniowane w bibliotece Pint, a także domyślne stałe.

Podczas pracy z jednostkami w portalu wymagań i systemów należy pamiętać:

• W jednostkach i przedrostkach rozróżniana jest wielkość liter. Na przykład kilogram powinien być zawsze "kg", a nigdy "Kg" lub "KG". Należy pamiętać o bibliotece jednostek Pint Library, jeśli pracujesz z jednostkami i nie masz pewności co do wielkości liter.

• Godzina jest skrótem "h" lub "hr". 'h' nie może być używane do reprezentowania stałej Plancka, w tym celu należy użyć 'planck_constant'

• Euro i dolar są obsługiwane jako jednostki, a ich konwersja została ustalona na 1 EUR = 1,123 USD (tę konwersję można zmienić w panelu administracyjnym, aby dopasować ją do aktualnej sytuacji ekonomicznej). Są one skracane odpowiednio jako "EUR" lub "euro" oraz "USD" i "dolar

• "dB" nie jest mapowane na "decybel", jak w domyślnej liście jednostek, ale jest mapowane na własną bezwymiarową jednostkę "decybel". Inne jednostki logarytmiczne (np. dBW) są uważane za jednostki niezdefiniowane i są obsługiwane w taki sam sposób, jak jednostki bezwymiarowe. Nie przewiduje się automatycznej konwersji między skalą liniową i logarytmiczną (np. dBW na W)

• Dla jednostek temperatury należy używać degC, degF i degK (lub tutaj po prostu K)

Należy zwrócić uwagę podczas korzystania z automatycznej konwersji wartości temperatury. Temperatury są jednostkami "niemnożnikowymi" i mają pewne szczególne zachowanie, które zostało wyjaśnione bardziej szczegółowo w dokumentacji Pint.

Można używać następujących przedrostków:

Decimal prefixes

yocto- = 1e-24 = y-  
zepto- = 1e-21 = z-  
atto- = 1e-18 = a-  
femto- = 1e-15 = f-  
pico- = 1e-12 = p-  
nano- = 1e-9 = n-  
mikro- = 1e-6 = u- = µ-  
mili- = 1e-3 = m-  
centi- = 1e-2 = c-  
deci- = 1e-1 = d-  
deca- = 1e+1 = da- = deka  
hekto- = 1e2 = h-  
kilo- = 1e3 = k-  
mega- = 1e6 = M-  
giga- = 1e9 = G-  
tera- = 1e12 = T-  
peta- = 1e15 = P-  
exa- = 1e18 = E-  
zetta- = 1e21 = Z-  
yotta- = 1e24 = Y-  

Binary prefixes

kibi- = 2^10 = Ki-  
mebi- = 2^20 = Mi-  
gibi- = 2^30 = Gi-  
tebi- = 2^40 = Ti-  
pebi- = 2^50 = Pi-  
exbi- = 2^60 = Ei-  
zebi- = 2^70 = Zi-  
yobi- = 2^80 = Yi-  

Można użyć dowolnej kombinacji przedrostka i jednostki, na przykład ks = kiloseconds, ponieważ zarówno przedrostek, jak i jednostka są zdefiniowane (1 kilosecond = 1000 seconds).

Nieobsługiwane jednostki

Używanie operatorów jako jednostek nie jest obsługiwane. Na przykład %, -, &, $, #, °. Te wartości będą traktowane jako bezwymiarowe i zostanie wygenerowane ostrzeżenie (z kodem 2115). Na przykład jednostka % nie będzie traktowana jako wartość procentowa (50% = 0.5), ale jako wartość surowa (50).

Jednostki niestandardowe

Administratorzy mogą definiować niestandardowe jednostki na stronie Settings, która jest widoczna tylko dla użytkowników-administratorów. Administratorzy mogą tworzyć niestandardowe jednostki, które nie są zdefiniowane w bibliotece Pint. Aby uzyskać dostęp do ustawień Custom Units, kliknij ikonę Settings(1) i przejdź do sekcji Custom Units(2) w menu ustawień.

Administratorzy mogą dodawać nowe jednostki niestandardowe, klikając ikonę + lub "Dodaj jednostkę niestandardową"(3) i definiować jednostki z istniejącymi jednostkami w bibliotece punktów.