simulation-metrics

Skill do analizy wyników symulacji systemów sterowania. Automatycznie wylicza cztery kluczowe metryki: czas narastania (10%–90% wartości docelowej), przekroczenie procentowe, błąd stanu ustalonego oraz czas ustalania się w paśmie tolerancji. Idealna dla inżynierów testujących algorytmy regulacji i oceniających jakość odpowiedzi systemu na podstawie danych czasowych.

1. Przygotuj dane wyjściowe z symulacji w postaci listy słowników, gdzie każdy wiersz zawiera klucze 'time' (czas) i 'value' (wartość zmierzona). Upewnij się, że masz również zdefiniowaną wartość docelową (target), do której system powinien dążyć.

2. Zaimportuj funkcje metryki z tego skilla: rise_time, overshoot_percent, steady_state_error oraz settling_time. Każda funkcja przyjmuje listy czasów i wartości oraz wartość docelową.

3. Aby obliczyć czas narastania, wywołaj rise_time(times, values, target), gdzie times to lista czasów, values to lista wartości, a target to wartość docelowa. Funkcja zwróci czas przejścia od 10% do 90% wartości docelowej.

4. Aby uzyskać przekroczenie procentowe, użyj overshoot_percent(values, target). Funkcja porówna maksymalną wartość w danych z wartością docelową i zwróci procentowe przekroczenie.

5. Do pomiaru błędu stanu ustalonego wywołaj steady_state_error(values, target), która oblicza średnią z ostatniej 10% danych i porównuje ją z wartością docelową. Zwraca bezwzględną różnicę.

6. Na koniec oblicz czas ustalania się za pomocą settling_time(times, values, target, tolerance), gdzie tolerance to domyślnie 0.02 (2% pasmo). Funkcja zwróci czas, w którym system po raz ostatni opuszcza pasmo tolerancji wokół wartości docelowej.