Konfiguracja właściwości wideo¶

Karta Właściwości wideo wyświetla i umożliwia ręczną konfigurację parametrów pliku wideo. Jest to kluczowe dla zapewnienia dokładnej analizy ruchu, obliczeń prędkości i prawidłowej detekcji obiektów.

Przegląd¶

AITracker automatycznie odczytuje metadane wideo z nagłówków plików (szerokość, wysokość, FPS). Jednak czasami te metadane są nieprawidłowe lub brakuje, co może negatywnie wpłynąć na:

Dokładność detekcji obiektu
Obliczenia prędkości i prędkości
Synchronizację znaczników czasu
Generowanie raportu

Konfiguracja właściwości wideo pozwala na zastąpienie tych parametrów ręcznie, gdy jest to potrzebne.

Parametry wideo¶

Szerokość wideo (px)¶

Domyślnie: Automatycznie wykrywane z pliku wideo
Zakres: 256 - 9999 pikseli
Cel: Określa rozdzielczość poziomą kadru wideo

Używane do obliczeń systemu współrzędnych
Wpływa na detekcję rozmiaru obiektu
Krytyczne dla korekcji perspektywy

Wysokość wideo (px)¶

Domyślnie: Automatycznie wykrywane z pliku wideo
Zakres: 256 - 9999 pikseli
Cel: Określa rozdzielczość pionową kadru wideo

Używane do obliczeń systemu współrzędnych
Wpływa na detekcję rozmiaru obiektu
Ważne dla obliczeń trajektorii

Wideo FPS (Klatki na sekundę)¶

Domyślnie: Automatycznie wykrywane z pliku wideo
Zakres: 1 - 256 FPS
Cel: Określa szybkość klatek wideo

Krytyczne dla obliczeń prędkości - nieprawidłowy FPS prowadzi do błędnych pomiarów prędkości
Wpływa na dokładność czasową śledzenia obiektów
Wpływa na generowanie znaczników czasu w raportach
Niezbędne do synchronizacji wielu źródeł wideo

Wymuś parametry wideo¶

Pole wyboru: VideoForce
Cel: Gdy włączone, zastępuje automatycznie wykrytych wartości ręcznie określonymi parametrami

Kiedy używać ręcznego zastąpienia¶

Typowe scenariusze wymagające ręcznej konfiguracji:¶

Nieprawidłowy FPS w nagłówku wideo

Przykład: Plik wideo zgłasza 25 FPS w metadanych, ale został faktycznie nagrany z 15 FPS. Ta różnica 67% spowoduje ogromne błędy w obliczeniach prędkości.
Wideo o zmiennej szybkości klatek
Niektóre kamery produkują pliki VFR (Variable Frame Rate)
Ręczne ustawienie FPS używa średniej szybkości klatek
Ponownie kodowane wideo
Wideo konwertowane między formatami może mieć nieprawidłowe metadane
Oryginalne parametry rejestracji mogą różnić się od bieżącego pliku
Uszkodzenia nagłówków wideo
Uszkodzone pliki mogą zgłaszać zero lub nieprawidłowe wymiary
Ręczne zastąpienie pozwala na przetwarzanie pomimo uszkodzenia
Wymogi przetwarzania w chmurze
Zapewnienie spójnych parametrów w wielu plikach
Standaryzacja właściwości wideo do przetwarzania zbiorczego

Reguły sprawdzania poprawności¶

Przy aktualizacji z interfejsu użytkownika (update_from_ui metoda):

Sprawdzenie poprawności szerokości: - Musi być prawidłową liczbą - Zakres: 256 ≤ szerokość ≤ 9999 - Zalogowany błąd, jeśli poza zakresem

Sprawdzenie poprawności wysokości: - Musi być prawidłową liczbą - Zakres: 256 ≤ wysokość ≤ 9999 - Zalogowany błąd, jeśli poza zakresem

Sprawdzenie poprawności FPS: - Musi być prawidłową liczbą zmiennoprzecinkową - Zakres: 1,0 ≤ fps ≤ 256,0 - Zalogowany błąd, jeśli poza zakresem

Jak wymuszanie działa¶

Kiedy wymuszone: - Parametry ręczne zastępują wartości automatycznie wykryte - Wszystkie czytniki wideo używają określonych wymiarów i FPS - Parametry są zapisywane z konfiguracją - Stosowane spójnie na wszystkich etapach przetwarzania

Wpływ na przetwarzanie¶

Obliczenia prędkości¶

Neprawidłowy FPS ma najpoważniejszy wpływ na pomiary prędkości:

Rzeczywisty FPS	Zgłoszony FPS	Błąd prędkości
15	25	+67% (prędkości wydają się szybsze)
25	15	-40% (prędkości wydają się wolniejsze)
30	25	+20% (prędkości wydają się szybsze)

Detekcja obiektu¶

Nieprawidłowe wymiary wpływają na: - Wydajność detektora AI - mniejsze obiekty w kadrze zmniejszają dokładność detekcji - Obliczenia perspektywy - nieprawidłowy stosunek proporcji zniekształca analizę trajektorii - Pozycjonowanie sekcji krzyżowej - współrzędne mogą nie być prawidłowo wyrównane

Przetwarzanie w chmurze¶

Przy przetwarzaniu w chmurze: - Wymuszone parametry zapewniają spójność - Zapobiega błędom automatycznej detekcji - Utrzymuje dokładność na rozproszczonych węzłach przetwarzania

Najlepsze praktyki¶

1. Sprawdź przed przetworzeniem¶

Zawsze sprawdzaj właściwości wideo przed rozpoczęciem analizy: - Odtwórz wideo w odtwarzaczu multimedialnym (VLC, ffplay), aby sprawdzić rzeczywisty FPS - Użyj narzędzi ffprobe lub mediainfo do inspekcji metadanych - Porównaj zgłoszone wartości ze specyfikacją kamery

2. Konfiguracja testowa¶

Przed przetworzeniem dużych partii: - Test z wymuszonymi parametrami na jednym pliku - Sprawdź, czy obliczenia prędkości są rozsądne - Sprawdź, czy detekcja obiektu działa prawidłowo

3. Dokumentowanie zastąpień¶

Na którym używasz parametrów ręcznych: - Dokumentuj, dlaczego zastąpienie było konieczne - Rejestruj oryginalne vs. skorygowane wartości - Prowadź notatki do przyszłego użytku

4. Sprawdzanie poprawności wyników¶

Po przetworzeniu z wymuszonymi parametrami: - Przejrzyj statystyki prędkości dla rozsądności - Sprawdź liczby obiektów względem oczekiwań - Sprawdź, czy znaczniki czasu są wyrównane ze znanymi zdarzeniami

Przykład przepływu pracy¶

Problem: Nieprawidłowy FPS¶

Detekcja: Zauważ nierealistyczne prędkości w wynikach (np. samochody podróżujące 150 km/h w mieście)
Dochodzenie: Sprawdź metadane wideo - pokazuje 25 FPS
Weryfikacja: Odtwórz wideo w VLC - rzeczywista szybkość klatek to 15 FPS
Korekta:
Otwórz kartę Właściwości wideo
Wprowadź prawidłowy FPS: 15.0
Włącz pole wyboru "Wymuś parametry wideo"
Zapisz konfigurację
Reklasyfikacja: Uruchom reklasyfikację, aby przeliczone prędkości
Sprawdzenie: Sprawdź, czy prędkości są teraz realistyczne (30-50 km/h)

Powiązane funkcje¶

Reklasyfikacja - Po zmianie parametrów wideo, reklasyfikuj, aby przeliczone prędkości
Pomiar prędkości/dystansu - Mocno zależy od prawidłowych wartości FPS
Zarządzanie konfiguracją - Właściwości wideo są zapisywane na konfigurację

Notatki¶

Właściwości wideo nie-modyfikowalne po liczeniu - zmiana ich wymaga ponownego przetwarzania lub reklasyfikacji
Parametry są przechowywane w config.json dla każdej konfiguracji
Wartości domyślne (0) oznaczają "użyj automatycznie wykrytych wartości"
Wymuszone parametry zastępują wartości domyślne dla wszystkich plików w lokalizacji