value-converter

Opis

Bloczek value-converter wykonuje liniową konwersję wartości numerycznej z jednego przedziału na drugi. Posiada jedno wejście i jedno wyjście. Wejście może być podłączone do wielu bloczków.

Bloczek przyjmuje tylko wartości numeryczne. Wartości nienumeryczne oraz wartości liczbowe spoza skonfigurowanego przedziału wejściowego są ignorowane.

Bloczek obsługuje zarówno przedziały rosnące, jak i malejące. Oznacza to, że poprawne są zarówno konfiguracje typu 0 -> 100, jak i 100 -> 0.

Parametry konfiguracyjne

Nazwa parametru	Wartość
input_range_begin	Parametr obowiązkowy określający początek przedziału wejściowego. Dozwolony zakres to od -1500000.000 do 1500000.000. Część ułamkowa nie może mieć większej precyzji niż określona w parametrze precision.
input_range_end	Parametr obowiązkowy określający koniec przedziału wejściowego. Dozwolony zakres to od -1500000.000 do 1500000.000. Część ułamkowa nie może mieć większej precyzji niż określona w parametrze precision. Wartość musi być różna od input_range_begin.
output_range_begin	Parametr obowiązkowy określający początek przedziału wyjściowego. Dozwolony zakres to od -1500000.000 do 1500000.000. Część ułamkowa nie może mieć większej precyzji niż określona w parametrze precision.
output_range_end	Parametr obowiązkowy określający koniec przedziału wyjściowego. Dozwolony zakres to od -1500000.000 do 1500000.000. Część ułamkowa nie może mieć większej precyzji niż określona w parametrze precision. Wartość musi być różna od output_range_begin.
precision	Parametr obowiązkowy określający liczbę miejsc po przecinku na wyjściu. Dozwolone wartości to 0, 1, 2, 3. Ta sama precyzja ogranicza również maksymalną dopuszczalną liczbę cyfr po przecinku w parametrach zakresów.

Obsługa wejścia

Bloczek reaguje wyłącznie na wartości numeryczne mieszczące się w przedziale wejściowym.

Zasady działania:

• Dla wartości input_range_begin na wyjściu zwracane jest dokładnie output_range_begin.
• Dla wartości input_range_end na wyjściu zwracane jest dokładnie output_range_end.
• Dla wszystkich pozostałych wartości z przedziału wejściowego wykonywane jest liniowe przeskalowanie do przedziału wyjściowego.
• Wynik jest zaokrąglany do liczby miejsc po przecinku określonej przez precision.
• Połówki są zaokrąglane od zera, czyli przykładowo 1.235 przechodzi w 1.24, a -1.235 przechodzi w -1.24.

Bloczek nie wymaga stosowania wejść oznaczanych za pomocą bloczka tag.

Wyjścia bloczka

Numer i nazwa wyjścia	Opis wyjścia
1. Przeskalowana wartość.	Zwraca wartość numeryczną obliczoną na podstawie bieżącego przedziału wejściowego i wyjściowego. Typ wyniku jest automatycznie ustawiany jako liczba całkowita albo zmiennoprzecinkowa zależnie od końcowej wartości po zaokrągleniu.

Opis statusu bloczka

Po każdej udanej konwersji pole description przyjmuje postać <left> -> <right>, gdzie:

• left to wartość wejściowa bez jednostki,
• right to wartość wyjściowa po konwersji również bez jednostki.

Jeżeli nie uda się uzyskać tekstowej reprezentacji którejś ze stron, w jej miejscu pojawia się napis unknown.

Błędy zwracane przez bloczek

Bloczek może zwracać następujące błędy:

Kod błędu	Opis błędu
Invalid precision configuration.	Parametr precision nie został podany albo ma wartość inną niż 0, 1, 2 lub 3.
Invalid input_range_begin configuration.	Parametr input_range_begin jest niepoprawny, ma wartość spoza dozwolonego zakresu albo ma zbyt dużą precyzję względem precision.
Invalid input_range_end configuration.	Parametr input_range_end jest niepoprawny, ma wartość spoza dozwolonego zakresu albo ma zbyt dużą precyzję względem precision.
Invalid output_range_begin configuration.	Parametr output_range_begin jest niepoprawny, ma wartość spoza dozwolonego zakresu albo ma zbyt dużą precyzję względem precision.
Invalid output_range_end configuration.	Parametr output_range_end jest niepoprawny, ma wartość spoza dozwolonego zakresu albo ma zbyt dużą precyzję względem precision.
Invalid input range configuration.	Początek i koniec przedziału wejściowego mają tę samą wartość.
Invalid output range configuration.	Początek i koniec przedziału wyjściowego mają tę samą wartość.
Input disconnected.	Do wejścia bloczka nie podłączono żadnego innego bloczka.