[Vineyard & Winery Elf](https://elf.intum.pl/kb/vineyard-winery-elf.md) / [Odczyt paneli](https://elf.intum.pl/kb/vineyard-winery-elf/odczyt-paneli.md)

# [Panel Reader - automatyczny odczyt mierników (Machine Vision)](https://elf.intum.pl/kb/vineyard-winery-elf/panel-reader-odczyt-zegarow-i-miernikow-b6zQsRbA.md)

## Opis funkcji

Panel Reader to moduł Machine Vision służący do automatycznego odczytu wartości z analogowych mierników (manometrów, termometrów) oraz wyświetlaczy cyfrowych. Wykorzystuje AI (Roboflow) do wykrywania wskazówek i interpretacji odczytów.

## Zastosowanie w winnicy

- **Manometry ciśnienia** - kontrola ciśnienia w zbiornikach, filtrach, butlach pét-nat
- **Termometry analogowe** - temperatura w zbiornikach fermentacyjnych i chłodniach
- **Wyświetlacze cyfrowe** - liczniki butelek, wyświetlacze temperatur

## Jak używać

1. **Wgraj zdjęcie** - zrób zdjęcie miernika z wyraźnie widoczną skalą i wskazówką
2. **Wybierz typ urządzenia** - manometr, termometr, wyświetlacz cyfrowy itp.
3. **Analiza AI** - system automatycznie wykryje środek tarczy i pozycję wskazówki
4. **Odczyt wartości** - obliczona wartość z jednostką i poziomem pewności

## Wspierane typy urządzeń

### Manometry analogowe
- `gauge_pet_nat` - manometry do butelek pét-nat
- `gauge_press` - manometry prasy
- `gauge_filter` - manometry filtrów
- `gauge_tank` - manometry zbiorników
- `analog_gauge` - ogólny manometr analogowy

### Wyświetlacze
- `digital_display` - wyświetlacze LCD/LED
- `counter` - liczniki
- `thermometer` - termometry (analogowe/cyfrowe)

### Panele sterowania
- `panel_press` - panel prasy
- `panel_pump` - panel pompy
- `panel_bottler` - panel rozlewni
- `control_panel` - ogólny panel sterowania

## Konfiguracja skali manometru

Dla dokładnych odczytów manometrów analogowych skonfiguruj skalę:

- **Min/Max wartość** - zakres skali (np. 0-6 bar)
- **Min/Max kąt** - kąty na tarczy dla wartości min i max
  - Typowy manometr: min=225° (lewy-dół), max=315° (prawy-dół)
  - Pełna skala to ~270° od min do max przez górę

## Algorytm odczytu manometru

1. **Detekcja AI** wykrywa:
   - `Center` - środek tarczy (punkt obrotu wskazówki)
   - `Needle` - wskazówka (używany środek bounding box)
   - `Needle Tip` / `Gauge Head` - końcówka wskazówki (preferowany, dokładniejszy)

2. **Obliczenie kąta** - wektor od środka do końcówki wskazówki
3. **Mapowanie na skalę** - interpolacja liniowa kąta na wartość

## Integracja z Roboflow

Panel Reader wykorzystuje modele AI wytrenowane na platformie Roboflow:

- **analog-gauge-meter/11** - manometry analogowe (Center+Needle+Tip)
- **digital-meter-detection/2** - wyświetlacze cyfrowe
- **meter-reading-lfqhb/1** - panele przemysłowe

### Konfiguracja API
1. Uzyskaj klucz API na [roboflow.com](https://roboflow.com)
2. Wprowadź klucz w sekcji "Konfiguracja Machine Vision"
3. Opcjonalnie zmień Model ID na własny wytrenowany model

## Training Dataset

System pozwala zapisywać zdjęcia z rzeczywistymi wartościami do trenowania własnych modeli:

1. Po analizie wprowadź **rzeczywistą wartość** odczytaną z miernika
2. Kliknij "Zapisz do treningu"
3. Dane są gromadzone do późniejszego eksportu i trenowania modelu

## Wskazówki do fotografowania

- **Oświetlenie** - równomierne, bez odblasków na szkle
- **Kąt** - prostopadle do tarczy miernika
- **Ostrość** - wyraźna skala i wskazówka
- **Kadrowanie** - cała tarcza w kadrze, bez przycinania

## Historia odczytów

System zapisuje ostatnie 50 odczytów z:
- Miniaturką zdjęcia
- Odczytaną wartością
- Typem urządzenia
- Datą i godziną