Skip to content

README_pl.md

Latest commit

 

History

History
381 lines (249 loc) · 18.5 KB

README_pl.md

File metadata and controls

381 lines (249 loc) · 18.5 KB

Stackistry

Copyright (C) 2016, 2017 Filip Szczerek (ga.software@yahoo.com)

wersja 0.3.0 (2017-06-05)

Niniejszy program ABSOLUTNIE nie jest objęty JAKĄKOLWIEK GWARANCJĄ. Jest to wolne oprogramowanie na licencji GNU GPL w wersji 3 (lub dowolnej późniejszej) i można je swobodnie rozpowszechniać pod pewnymi warunkami: zob. pełny tekst licencji w pliku LICENSE.

  • 1. Wprowadzenie
  • 2. Obsługiwane formaty plików
  • 3. Interfejs użytkownika
    • 3.1. Wybór klatek
    • 3.2. Ustawienia przetwarzania
    • 3.3. Punkty kotwiczące stabilizacji obrazu
    • 3.4. Wizualizacja
    • 3.5. Podgląd wyników
  • 4. Jakość klatek
  • 5. Pobieranie
  • 6. Budowanie ze źródeł
    • 6.1. Budowanie w systemie Linux (i podobnych)
    • 6.2. Budowanie pod MS Windows
    • 6.3. Język UI
  • 7. Historia zmian

Okno główne

1. Wprowadzenie

Stackistry realizuje metodę lucky imaging przetwarzania obrazów astronomicznych: tworzenie wysokiej jakości zdjęcia z wielu (nawet tysięcy) klatek niskiej jakości (rozmytych, zdeformowanych, z dużą ilością szumu). Wynikowy stack wymaga zwykle dodatkowej obróbki, w tym wyostrzania (np. dekonwolucją); kroków tych Stackistry nie wykonuje.

By uruchomić program po pobraniu dystrybucji binarnej dla MS Windows, należy użyć skryptu stackistry.bat (można utworzyć do niego skrót).

Wideoprzewodniki: https://www.youtube.com/watch?v=_68kEYBXkLw&list=PLCKkDZ7up_-VRMzGQ0bmmiXL39z78zwdE

2. Obsługiwane formaty plików

Formaty wejściowe:

  • AVI: nieskompresowany DIB (mono lub RGB), Y8/Y800
  • SER: mono, RGB, „raw color”
  • BMP: nieskompresowany 8-, 24- i 32-bitowy
  • TIFF: 8 i 16 bitów na kanał nieskompresowany mono lub RGB

Formaty wyjściowe:

  • BMP: nieskompresowany 8- i 24-bitowy
  • TIFF: 16-bitowy nieskompresowany mono lub RGB

64-bitowe wersje Stackistry nie mają ograniczeń co do rozmiaru wideo/obrazów wejściowych (poza ilością dostępnej pamięci operacyjnej). Na życzenie użytkownika materiał mono może być traktowany jak „raw color” (Stackistry przeprowadzi demozaikowanie).

3. Interfejs użytkownika

Większość pozycji menu ma odpowiedniki wśród przycisków na pasku narzędziowym lub w menu kontekstowym (otwieranym przez kliknięcie prawym przyciskiem myszy na liście zadań).

Za pomocą standardowych kombinacji klawiszy (Ctrl-klik, Shift-klik, Ctrl-A, Shift-End itd.) zaznaczyć można na liście wiele zadań naraz. Poniższe polecenia wykonywane są dla wszystkich zaznaczonych zadań:

  • Edycja/Ustawienia przetwarzania...
  • EdycjaUsuń z listy
  • Przetwarzanie/Rozpocznij przetwarzanie

W trakcie przetwarzania usuwanie i dodawanie zadań nie jest możliwe.

3.1. Wybór klatek

Użytkownik może wyłączyć niektóre klatki z przetwarzania używając polecenia Edycja/Wybierz klatki...; jest ono aktywne, gdy zaznaczono tylko jedno zadanie. W oknie dialogowym wyboru klatek można zaznaczyć ich wiele naraz za pomocą standardowych kombinacji klawiszy (Ctrl-klik, Shift-klik, Ctrl-A, Shift-End itd.). Naciśnięcie spacji przełącza stan wybranych klatek; klawisz Del deaktywuje je.

3.2. Ustawienia przetwarzania

Ustawienia przetwarzania można zmieniać dla wielu zadań naraz po zaznaczeniu ich na liście i wybraniu Edycja/Ustawienia przetwarzania.... Nazwy zadań, których ustawienia są edytowane, wymienione są w liście w górnej części okna dialogowego Ustawienia przetwarzania.

  • Metody stabilizacji obrazu

Stackistry dokonuje stabilizacji obrazu metodą śledzenia punktów kotwiczących lub centroidu jasności (“środka masy”). Używanie punktów kotwiczących jest zalecane dla Słońca i Księżyca. Centroid jasności sprawdza się w przypadku wideo planetarnych (gdzie automatyczne rozmieszczanie punktów kotwiczących może być zawodne).

W przypadku wybrania rozmieszczania ręcznego, okno dialogowe wyboru punktów zostanie wyświetlone w momencie rozpoczęcia przetwarzania danego zadania.

  • Rozmieszczenie punktów odniesienia

Obecnie rozmieszczenie automatyczne działa najlepiej dla wideo przedstawiających powierzchnię Słońca lub Księżyca. Dla wideo planetarnych niektóre punkty mogą zostać dodane w nieoptymalnych miejscach (gdzie ich śledzenie będzie zawodne). W takim przypadku należy wybrać rozmieszczenie ręczne; okno dialogowe wyboru punktów zostanie wyświetlone dla danego zadania w odpowiednim momencie w trakcie przetwarzania (tj. po zakończeniu fazy szacowania jakości). Należy unikać umieszczania punktów w obszarach z małą ilością szczegółów; dobrze sprawdzą się plamy słoneczne, filamenty, splątane fragmenty protuberancji, kratery, pasy chmur itp.

  • Kryterium stackowania

Kryterium to dotyczy zarówno śledzenia punktów odniesienia, jak i fazy stackowania (końcowego sumowania fragmentów klatek):

Uwaga: zbytnie zwiększanie odsetka (lub liczby) akceptowanych fragmentów klatek wydłuża czas pracy i może pogorszyć jakoś wynikowego stacku (jako że zsumowanych będzie więcej fragmentów słabej jakości).

  • Automatyczny zapis stacku

Jeśli automatyczne zapisywanie nie jest wyłączone, plik wynikowy otrzyma nazwę taką samą jak wideo wejściowe z przyrostkiem _stacked. W przypadku sekwencji plików graficznych nazwą będzie stack.

Niezależnie od wybranego trybu, w każdej chwili można zapisać stack dla każdego ukończonego zadania za pomocą polecenia Plik/Zapisz stack....

  • Użyj flatu

Flat (flat-field) to obraz stosowany w celu kompensacji różnic jasności mających źródło w torze optycznym (np. winietowanie, sweet spot etalonu, pierścienie Newtona itp.). Stackistry może wykorzystać flat stworzony w innym programie (o ile jest w jednym z obsługiwanych formatów), może też wygenerować go samodzielnie, zob. polecenie Plik/Wygeneruj flat z wideo.... Wideo użyte do tego celu musi być niewyostrzone i przedstawiać jednolicie oświetlony widok (bez szczegółów). Bezwględny poziom jasności nie jest istotny, natomiast krzywa tonalna musi mieć tę samą charakterystykę, co w przetwarzanym materiale (np. ustawienie krzywej gamma, o ile obecne w kamerze, musi być identyczne; wartości migawki i wzmocnienia mogą się różnić). W celu osiągnięcia najlepszych efektów należy użyć wideo o długości co najmniej kilkudziesięciu klatek, by szum został uśredniony.

  • Traktuj materiał mono jako „raw color”

Po włączeniu tej funkcji Stackisty dokonuje demozaikowania materiału mono metodą interpolacji liniowej wysokiej jakości (Malar, He, Cutler). Układ filtrów kolorowych (RGGB, GRBG itp.) nie jest wykrywany automatycznie, użytkownik musi wybrać właściwy. Jeśli układ nie jest znany, można zrobić to metodą prób i błędów, sprawdzając efekt np. w oknie wyboru klatek; z niewłaściwym układem uzyskamy obraz z pikselami „w kratkę” lub z zamienionymi kanałami czerwonym i niebieskim.

Funkcję można pozostawić wyłączoną dla plików wideo SER w formacie „raw color” (są demozaikowane automatycznie). Może się jednak zdarzyć, że układ filtrów wskazany w SER jest niewłaściwy; włączenie funkcji spowoduje wówczas wymuszenie właściwego układu.

3.3. Punkty kotwiczące stabilizacji obrazu

Ważną cechą Stackistry jest zdolność do nienadzorowanego przetwarzania dużej liczby zadań, dlatego też automatyczne rozmieszczanie punktów kotwiczących stabilizacji działa zwykle zadowalająco. Jeśli jednak zawiedzie, należy użyć polecenia Edycja/Ustaw punkty kotwiczące stabilizacji wideo... (lub wybrać ręczne rozmieszczanie punktów kotwiczących w ustawieniach przetwarzania, zob. punkt 3.2). Podobnie jak w przypadku punktów odniesienia, punkty kotwiczące nie powinny znajdować się w obszarach o małej szczegółowości.

Można dodać więcej niż jeden punkt, np. jeśli użytkownik wie, że niektóre z nich przemieszczą się poza kadr wskutek dryfu obrazu (wówczas Stackistry przełączy się na inny z dostępnych punktów). Nawet jeśli stanie się tak ze wszystkimi punktami, Stackistry automatycznie doda nowe w miarę potrzeby.

Jeśli nie występuje znaczny dryf obrazu, wystarczy zdefiniować jeden punkt kotwiczący.

3.4. Wizualizacja

Włączana/wyłączana poleceniem Przetwarzanie/Pokaż wizualizację (można użyć go w każdej chwili), funkcja ta generuje „podgląd diagnostyczny” kolejnych etapów przetwarzania. Można użyć jej np. w celu zweryfikowania, że punkty kotwiczące działają prawidłowo, lub że punkty odniesienia są prawidłowo rozmieszczone i śledzone. Uwaga: włączona wizualizacja spowalnia pracę programu.

3.5. Podgląd wyników

Oprócz wizualizacji przetwarzania, w prawej części okna głównego można wyświetlić również stack lub zestawienie najlepszych fragmentów klatek (dla podświetlonego na liście zadania). Stack jest dostępny, jeśli przetwarzanie zadania zostało zakończone. Zestawienie najlepszych fragmentów można wyświetlić po zakończeniu etapu szacowania jakości.

Zarówno zestawienie, jak i stack można zapisać za pomocą poleceń z menu Plik (lub menu kontekstowego listy zadań, dostępnego po kliknięciu prawym przyciskiem myszy).

4. Jakość klatek

Jeśli etap szacowania jakości został zakończony, dane o jakości klatek wybranego zadania można wyświetlić w dedykowanym oknie (włączanym poleceniem Widok/Wykres jakości klatek lub odpowiadającym mu przyciskiem na pasku narzędziowym). Wartości jakości są znormalizowane do zakresu [0; 1].

Dane o jakości mogą zostać zapisane w pliku tekstowym (który później można np. zaimportować do arkusza kalkulacyjnego) poleceniem z menu Plik lub przyciskiem Eksportuj... w oknie wykresu jakości. Zapis automatyczny można włączyć w oknie ustawień przetwarzania (wynikowy plik tekstowy pojawi się w tym samym miejscu, co stack, pod nazwą z przyrostkiem _frame_quality).

W oknie Edycja/Preferencje... można zdecydować, czy podczas eksportu uwzględniane mają być również nieaktywne klatki (zob. punkt 3.1). Przykładowo, jeśli zadanie zawiera 10 klatek i wszystkie są aktywne, zapisane dane mają postać:

Frame;Active frame;Quality
0;0;0.55
1;1;0.56
2;2;0.56
3;3;0.56
4;4;0.56
5;5;0.56
6;6;0.56
7;7;0.56
8;8;0.56
9;9;0.56

Jeśli użytkownik wyłączy klatki 3, 4, 5, a opcja eksportu nieaktywnych jest wyłączona:

Frame;Active frame;Quality
0;0;0.55
1;1;0.56
2;2;0.56
6;3;0.56
7;4;0.56
8;5;0.56
9;6;0.56

Tj. kolumna Frame zawiera indeks bezwględny klatki, a Active frame zlicza tylko te aktywne.

Jeśli eksport nieaktywnych klatek jest włączony, wynikiem będzie:

Frame;Active frame;Quality
0;0;0.55
1;1;0.56
2;2;0.56
3;-1;0
4;-1;0
5;-1;0
6;3;0.56
7;4;0.56
8;5;0.56
9;6;0.56

Uwzględnienie nieaktywnych klatek może być przydatne np. przy porównywaniu z danymi zebranymi przez monitor scyntylacji słonecznej (SSM).

5. Pobieranie

Kod źródłowy i pliki wykonywalne dla MS Windows można pobrać pod adresem:

https://github.com/GreatAttractor/stackistry/releases

6. Budowanie ze źródeł

Budowanie ze źródeł wymaga narzędzi do kompilacji C++ (z obsługą C++11) oraz bibliotek gtkmm 3.0 i libskry. Wersje (tagi) Stackistry i libskry powinny być te same; można też użyć najnowszych rewizji obydwu projektów (aczkolwiek mogą być niestabilne).

6.1. Budowanie w systemie Linux (i podobnych)

Z kodem dostarczony jest plik Makefile zgodny z GNU Make. By zbudować aplikację, należy zainstalować biblioteki gtkmm 3.0 (których pakiety noszą zwykle nazwy gtkmm30 i gtkmm30-devel lub podobne), pobrać (z https://github.com/GreatAttractor/libskry/releases) i zbudować libskry, przejść do folderu z kodem źródłowym Stackistry, ustawić odpowiednio wartości w sekcji User-configurable variables w Makefile i wykonać:

$ make

Utworzony zostanie plik wykonywalny ./bin/stackistry. Można przenieść go w dowolne miejsce, o ile foldery ./icons i ./lang zostaną umieszczone na tym samym poziomie, co ./bin.

Jeśli libskry została zbudowana z włączoną obsługą libav, Stackistry musi zostać zbudowane z dołączonymi bibliotekami libav. Są zwykle dostępne jako pakiet o nazwie ffmpeg-devel lub podobnej. W przeciwnym wypadku można je wybudować ze źródeł, wykonując:

$ git clone https://git.ffmpeg.org/ffmpeg.git
$ cd ffmpeg
$ ./configure --disable-programs --enable-gray --disable-muxers --disable-demuxers --enable-demuxer=avi --disable-encoders --disable-decoders --enable-decoder=rawvideo --enable-decoder=bmp --disable-protocols --enable-protocol=file --disable-parsers --disable-devices --disable-hwaccels --disable-bsfs --disable-filters --disable-bzlib --disable-lzma --disable-schannel --disable-xlib --disable-zlib --disable-iconv
$ make
$ make install

Ubuntu i libav

W Ubuntu niezbędne są następujące pakiety: ffmpeg libavcodec-dev libavformat-dev libavutil-dev.

W przypadku Ubuntu 16.04 standardowo dostępne wersje są zbyt stare. Przed zainstalowaniem pakietów należy dodać repozytorium z nowszymi:

sudo add-apt-repository ppa:jonathonf/ffmpeg-3
sudo apt update

6.2. Budowanie pod MS Windows

Budowanie z użyciem dostarczonego pliku Makefile zostało przetestowane w środowisku MinGW/MSYS. Plik wykonywalny (stackistry.exe) tworzony jest po wykonaniu tych samych kroków, co w punkcie 6.1 (w linii poleceń środowiska MSYS).

Uwagi dodatkowe

Instalator MSYS2 pobrać można z https://msys2.github.io/ (należy postępować zgodnie z zamieszczoną tam instrukcją). Po zakończeniu instalacji trzeba uruchomić konsolę MSYS i zainstalować wymagane narzędzia i biblioteki. Dla 64-bitowego GCC należy wykonać:

$ pacman -S make base-devel mingw-w64-x86_64-toolchain

(pakiet 32-bitowy nosi nazwę mingw-w64-i686-toolchain).

By zainstalować 64-bitowe GTK i gtkmm, wykonać:

$ pacman -S mingw-w64-x86_64-gtk3 mingw-w64-x86_64-gtkmm3

W przyszłości nazwy pakietów mogą ulec zmianie; by wyświetlić prawidłowe nazwy dla konkretnych bibliotek, można wykonać:

$ pacman -Ss gtk3
$ pacman -Ss gtkmm

Przed budowaniem należy odpowiednio ustawić zmienną PATH. Dla 64-bitowego GCC:

$ export PATH=/mingw64/bin:$PATH

Obecnie MSYS2 nie dostarcza pakietów z bibliotekami libav. Można je wybudować ze źródeł jak w p. 6.1, po wcześniejszym zainstalowaniu Gita i asemblera Yasm:

$ pacman -S git yasm

Do wywołania skryptu ./configure należy przekazać dodatkowy parametr: --prefix=$MSYSTEM_PREFIX.

MSYS montuje napędy jako /<litera_dysku>, więc jeśli źródła Stackistry zostały umieszczone w:

C:\Users\NazwaUżytkownika\Documents\stackistry

będą widoczne z poziomu MSYS jako:

/c/Users/NazwaUżytkownika/Documents/stackistry

Po zbudowaniu, Stackistry można uruchomić z linii poleceń MSYS (./bin/stackistry.exe). By możliwe było uruchomienie programu bezpośrednio z Eksploratora Windows, niezbędne biblioteki DLL i inne pliki pomocnicze muszą być umieszczone w odpowiednich (względem stackistry.exe) miejscach (zob. binarną dystrybucję Stackistry dla porównania).

6.3. Język UI

Stackistry obsługuje wielojęzyczny interfejs użytkownika poprzez pakiet GNU gettext. Bieżący język można zmienić poleceniem Edycja/Preferencje....

Wszystkie wymagające tłumaczenia napisy w kodzie źródłowym otoczone są makrem _(). Dla dodania nowego tłumaczenia konieczne jest wykonanie następujących kroków:

  • ekstrakcja napisów do przetłumaczenia z kodu źródłowego do pliku PO poprzez wykonanie:
$ xgettext -k_ src/*.cpp src/*.h -o stackistry.po

  • przetłumaczenie napisów UI, tj. edycja wpisów msgstr w stackistry.po (przetłumaczone napisy muszą być w UTF-8)

  • konwersja stackistry.po do postaci binarnej:

$ msgfmt stackistry.po -o stackistry.mo

  • umieszczenie stackistry.mo w podkatalogu lang/<lang_country>/LC_MESSAGES, gdzie lang to kod języka (ISO 643), a country – kod kraju (ISO 3166), np. de_DE, fr_CA

  • dopisanie języka do tablicy Utils::Const::languages (src/utils.h)

Dystrybucja binarna Stackistry potrzebuje jedynie plików MO (binarnych). Dystrybucja dla Windows wymaga dodatkowo umieszczenia plików językowych gtkmm w następujących lokacjach w katalogu Stackistry:

share/locale/<lang>/LC_MESSAGES/gtk30.mo
share/locale/<lang>/LC_MESSAGES/gtk30-properties.mo

7. Historia zmian

0.3.0 (2017-06-05)
  Nowe funkcje:
    - Lepsza obsługa plików AVI dzięki libav
  Poprawki błędów:
    - Naprawiono błędy występujące podczas triangulacji

0.2.0 (2017-01-07)
  Nowe funkcje:
    - Stabilizacja wideo z użyciem centroidu jasności (przydatna do planet)
    - Ulepszone automatycznie rozmieszczanie punktów odniesienia dzięki wykrywaniu struktur w obrazie
    - Skalowanie podglądu obrazów
    - Więcej ustawień dotyczących automatycznego rozmieszczania punktów odniesienia
    - Wyświetlanie i eksport danych o jakości klatek
    - Generowanie zestawienia najlepszych fragmentów wszystkich klatek
  Poprawki błędów:
    - Błąd przy otwieraniu plików AVI utworzonych przez FFMPEG

0.1.1 (2016-08-05)
  Nowe funkcje:
    - Obsługa plików AVI Y8/Y800
  Ulepszenia:
    - Możliwość wyboru progu jasności dla automatycznego rozmieszczania punktów odniesienia

0.1.0 (2016-06-06)
  Nowe funkcje:
    - Obsługa wielojęzycznego interfejsu użytkownika
    - Polska wersja językowa

0.0.3 (2016-05-22)
  Nowe funkcje:
    - Demozaikowanie materiału „raw color”
  Poprawki błędów:
    - Błąd przy otwieraniu plików SER nagranych narzędziem Genika
    - Zła kolejność kanałów RGB przy zapisywaniu BMP

0.0.2 (2016-05-08)
  Poprawki błędów:
    - Naprawiono błędy podczas przetwarzania serii plików TIFF
    - Wykorzystywane są wszystkie fragmenty, jeśli kryterium to
      „liczba najlepszych”, a próg jest większy niż liczba aktywnych klatek

0.0.1 (2016-05-01)
  Pierwsza wersja.