Diplomova prace 
Martin Krupicka
FEL CVUT
leden 2017

Jak teoreticka, tak prakticka cast teto prace 
vychazi z materialu vypracovanych v ramci magisterskeho
predmetu Projekt individualni (A2M37IND).



Tento soubor slouzi k seznameni s napsanymi skripty a dava strucny navod, jak je vyuzit.
Je zde popsan postup kroku nutny k ziskani spravnych vysledku prostrednictvim techto skriptu.
Dalsi informace lze nalezt take primo v samotnych skriptech. Je v nich strucne popsana
jejich funkce a pritomno je take mnoho komentaru k jednotlivym krokum.

Predpoklada se, ze mate naistalovane prostredi MATLAB a muzete vyuzivat MEX soubory.
(viz https://www.mathworks.com/help/matlab/matlab_external/introducing-mex-files.html?requestedDomain=www.mathworks.com)

POZOR: Vse bylo realizovano na pocitaci s macOS Sierra. Nelze s jistotou garantovat spravnou
funkcnost na pocitacich s jinymi operacnimi systemy. Pravdepodobne by mel byt problem pouze
ve skriptech realizujicich JPEG XT kodovani a dekodovani. V nich je funkce system, jejiz obsah
bude zrejme nutne upravit podle uzivaneho operacniho systemu.
(napoveda k funkci: https://www.mathworks.com/help/matlab/ref/system.html?requestedDomain=www.mathworks.com)



%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


1) Nainstalujte si Banterleho HDR Toolbox dostupny z http://www.advancedhdrbook.com/. 

Prislusi k nemu literatura

BANTERLE, Francesco, Alessandro ARTUSI, Kurt DEBATTISTA a Alan CHALMERS. Advanced High Dynamic Range Imaging: Theory and Practice. 1. Natick, MA, USA: AK Peters (CRC Press), 2011. ISBN 978-156-8817-194.

Citovano 4. 1. 2016.


2) Stahnete si JPEG XT referencni software z https://jpeg.org/jpegxt/software.html, konkretne variantu JPEG XT
od Thomase Richtera. Tento software vhodne zkompilujte v zavislosti na svem operacnim systemu.
S kompilaci Vam muze pomoct text diplomove prace, konkretne pododdily 6.3 a 11.1.


3) Stahnete si vstupni obrazova data ve formatu OpenEXR z jedne z databazi zminenych v kapitole 4 diplomove prace. 
Pro prvni vyzkouseni skriptu doporucuji zvolit jeden ze souboru popsanych v oddilu 7.2.1 diplomove prace. 
Samozrejme vsak muzete zvolit i nejaky jiny.


4) Stazene obrazove soubory umistete do stejne slozky, kde mate zkompilovany JPEG XT referencni software.


5) Do stejne slozky zkopirujte vsechny prilozene MATLAB skripty.


6) Vstupni obrazovy soubor prejmenujte na in1_HDR.exr. Pokud jich budete chtit pouzivat vic, tak dalsi pojmenujte
in2_HDR.exr, in3_HDR.exr atd.

UPOZORNENI: Zakladni predpripraveny scenar pocita se dvema vstupnimi obrazovymi soubory. Pro jeho funkcnost tedy
umistete do pracovni slozky dva vstupni soubory pojmenovane in1_HDR.exr a in2_HDR.exr. Ve skriptech s nimi bude
pracovano jako s in1 a in2. 


7) Nyni uz zacneme vyuzivat samotne skripty. Jsou pripraveny tak, abyste je pri prvnim seznameni
mohli pouze otevrit a spustit. Pokud je nechate probehnout ve spravnem, dale popsanem,
poradi, uvidite demonstraci jejich funkcnosti. Pro jina vyuziti uz budete muset do skriptu 
nahlednout a podle potreby menit ruzna nastaveni, pojmenovani atp. Snazil jsem se udelat to tak, 
aby to slo pomerne snadno a jednoduse. Pro nektera vyuziti je to komplikovanejsi, pro jina mene.
Nasleduje poradi, ve kterem byste meli spustit skripty pro realizaci zakladniho predpripraveneho
scenare.

POZOR: Vse bylo realizovano na pocitaci s macOS Sierra, nelze tedy s jistotou garantovat spravnou
funkcnost na pocitacich s jinymi operacnimi systemy. Pravdepodobne by mel byt problem pouze
ve skriptech realizujicich JPEG XT kodovani a dekodovani. V nich je funkce system, jejiz obsah
bude zrejme nutne upravit podle uzivaneho operacniho systemu.
(napoveda k funkci: https://www.mathworks.com/help/matlab/ref/system.html?requestedDomain=www.mathworks.com)

UPOZORNENI: Zakladni predpripraveny scenar ma pro udrzeni nizke vypocetni narocnosti velmi hruby 
krok v uzivanych hodnotach parametru kvality. Jedna se hlavne o demonstraci funkcnosti.

	a) Spustte skript prevod_EXR_na_PFM_nonnegative.m

	b) Spustte skript zjisteni_dynamickeho_rozsahu_a_rozliseni.m

	c) Spustte skript fotoaparat_JPEG_PNG_uniform_PFM_s_cyklem.m

	d) Spustte skript mapovani_tonu_a_ulozeni_PPM_Drago.m
	   
	   Muzete vyzkouset i verze s iCAM06 a KimKautz a podivat se na vystupy alespon 
	   vizualne, i kdyz je v predpripravenem scenari dale nijak nevyuzijete.

	e) Spustte skript JPEG_XT_kodovani.m

	   Je pripraveno kodovani v profilu C s vyuzitim parametru -rR 4.

	f) Spustte skript JPEG_XT_zpetne_dekodovani.m
	
Tim bychom meli za sebou zakladni cast. Nyni je na rade vyhodnoceni vysledku. V zavislosti 
na tom, co nas zajima, je nutne pripravit vyhodnocovaci a vykreslovaci skript na miru.
Ukazka je prilozena. Jsou take pripraveny na vyuziti v predpripravenem scenari, takze je
muzete spustit ihned po provedeni kroku a) - f). Pro jine vyuziti je treba je upravit,
nektere vice, nektere mene.

	g) Spustte skript bitove_toky_a_velikosti_serie_JPEG_XT_souboru.m

	h) Spustte skript SNR_MSE_NLDRJPEG_slozeny_HDR_ruzne_JPEG_q.m

	i) Spustte skript SNR_MSE_velke_Q_bitovy_tok_Drago_JPEGXT.m


UPOZORNENI: Vysledky nejsou az na jednu vyjimku vykreslovany. V tak malem poctu bodu by byly zavadejici. 
Krok je velmi hruby. Pro graficke znazorneni ruznych situaci nahlednete do textu diplomove prace.
Pripadne prenastavte ve skriptech krok parametru kvality na mensi hodnotu. Dulezite hodnoty jsou ukladany
do tabulky, ktera je po probehnuti skriptu ulozena do MAT souboru.


V ramci psani diplomove prace byly samozrejmě napsany i dalsi skripty, avsak ty dulezite jsou zde 
popsany a vyuzity. Ostatni jsou velmi podobneho razu. Rozdilne jsou hlavne v nastaveni a ruznych 
drobnych upravach podle aktualni potreby.