From 10d729d6660d56050ffcd05af371148c9b243558 Mon Sep 17 00:00:00 2001 From: Deepank308 Date: Sun, 13 Jan 2019 13:07:58 +0530 Subject: [PATCH] Add demonstration: Contrast and Brightness analysis using histograms --- docs/make.jl | 1 + .../assets/demos/histogramEq/brightHist.jpg | Bin 0 -> 7125 bytes .../src/assets/demos/histogramEq/darkHist.jpg | Bin 0 -> 5274 bytes .../assets/demos/histogramEq/darkimage.png | Bin 0 -> 31537 bytes docs/src/assets/demos/histogramEq/eqhist.jpg | Bin 0 -> 12211 bytes .../src/assets/demos/histogramEq/highHist.jpg | Bin 0 -> 8120 bytes .../assets/demos/histogramEq/highcontrast.png | Bin 0 -> 50924 bytes .../assets/demos/histogramEq/lightimage.png | Bin 0 -> 37769 bytes docs/src/assets/demos/histogramEq/lowHist.jpg | Bin 0 -> 3470 bytes .../assets/demos/histogramEq/lowcontrast.png | Bin 0 -> 23424 bytes docs/src/demos.md | 20 ++++ .../demos/contrast_brightness_histogram.md | 104 ++++++++++++++++++ 12 files changed, 125 insertions(+) create mode 100644 docs/src/assets/demos/histogramEq/brightHist.jpg create mode 100644 docs/src/assets/demos/histogramEq/darkHist.jpg create mode 100644 docs/src/assets/demos/histogramEq/darkimage.png create mode 100644 docs/src/assets/demos/histogramEq/eqhist.jpg create mode 100644 docs/src/assets/demos/histogramEq/highHist.jpg create mode 100644 docs/src/assets/demos/histogramEq/highcontrast.png create mode 100644 docs/src/assets/demos/histogramEq/lightimage.png create mode 100644 docs/src/assets/demos/histogramEq/lowHist.jpg create mode 100644 docs/src/assets/demos/histogramEq/lowcontrast.png create mode 100644 docs/src/demos/contrast_brightness_histogram.md diff --git a/docs/make.jl b/docs/make.jl index be79f348..0a1c0dd9 100644 --- a/docs/make.jl +++ b/docs/make.jl @@ -21,6 +21,7 @@ makedocs(format = :html, "Demos" => Any[ "demos.md", "demos/color_separations_svd.md", + "demos/contrast_brightness_histogram.md", ], "function_reference.md", "api_comparison.md", diff --git a/docs/src/assets/demos/histogramEq/brightHist.jpg b/docs/src/assets/demos/histogramEq/brightHist.jpg new file mode 100644 index 0000000000000000000000000000000000000000..cc93ce5773a077476272a837f66b26d0bd41adf6 GIT binary patch literal 7125 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 literal 0 HcmV?d00001 diff --git a/docs/src/assets/demos/histogramEq/darkHist.jpg b/docs/src/assets/demos/histogramEq/darkHist.jpg new file mode 100644 index 0000000000000000000000000000000000000000..f212acddeae92ced0f99df75d338b9b65241b237 GIT binary patch literal 5274 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 literal 0 HcmV?d00001 diff --git a/docs/src/assets/demos/histogramEq/eqhist.jpg b/docs/src/assets/demos/histogramEq/eqhist.jpg new file mode 100644 index 0000000000000000000000000000000000000000..878f5b8ffd9db29bacc151705846e830f5bea0db GIT binary patch literal 12211 zcmb8VcT^M47dD>I3DTR=qzj=*Z%PLt^w0@Kno0>s69MVHL+H{m0YV2U0i`HKq)Uf@ zbdcVpgZ%h>f9E~t{r7$LoZZ=d=H7XB&zzZ^d*^QEZV5mEQPWTZ0D%Ai@csbYVFAhj zT%7;#-x>EFcm#O=frx+rpMaPM1R^FPCI&qqe*hvOBOxXxr6eUIr=Xyu06n0hrlO#} zFH`*I1o)pNE*{anAq5FB$^Fy+N8EJ+D2V`#fI3_tB>;yKh)W5)>jtpg>%_(XPwxK# zAwB^S00$S37zn!O*TAfRF+6js!yX15`t5pfTpRf47z z)e&=i`*ldSOwTE*Y+!rDC3f$C9{3;rkMsXsfjGGL1Ow&&nE#uj1PZe$y5G$K9^eA+ zCE`*7BJajqRF{{ydEDfoz_(!1I zClth5;PR+wSsH!{a(!EQIn!ja=TTA#Sr|A&-M43xAZqftSMqYm^04?B@k6Ti_9g~cqfsWywLA$ zN*aUBUz`RpHr`BTA0vOU8nUE-jJ}HT6sg7?*j>cbJ(qsT_~=C1$Ws8gJ`U!MV+VCb zDkUq4RoJ@lYd6neNfiuYvP}fs1tYjq@-2?C^I_f*0&_k$-G-(s zK0uESVh>fQ=81tGUPcze2;JREkcNySG0ma=hr=PkT8aNsq)7LfA)=Pw`-w9Qf5!tn z7p`344i+eTOscAEt}E=d|5S?A9`mzODNrkRK~bk@k)4*uk(Vjt_saRf=n}Q4npstp z)_b?I@9yTK1Flu0aXyWmEu7fvmr4wOq%&|qWnf{4CNd<3Y0RLl#(Dc8IZ^;}1Gzc+ z)a6lRjl&oH#3xg2whH~GFmZx833&!VIaCWzq|uz zzKr~^&#qP0ihAMR#B7r83~Ej9&`h{G-wZKb-So9OV@`iAM=8ncs6bh_-r@ha1URm{ z;#pZ#R)IKv^ky3$9;$OwEvP$e4#LeyJN?)7C6Pw6hf(WnNqo zJLoGmZF8}Y=|a%_)l*`uldWV}28v(r=7~h;W;M}mCsQ2n24@p5NNiIF zmj2xg$ANf?*s$vuRB`>VgoCMIx|uyL)%+xfXuyh`>3O%BbLO;bjJfW4 zB4%xgyQb&LR>{DPpn?^UzN;?c3SN%7^Kzr?@0#%bW? zuOFy*IJOwe;#u%II!ZPkz%33b7B3<;KjePR%Y2h&?)%E?V=GEhbOvqMl?D-&mdq!#1}ZFCIaZ*@hGYR0{ z3%^h#jSIk1y}JX*nyb=!OcP@~Q%BRF9&0pdtgJls`3kTmkO$cCp~mPqk81n2fs0-? zhj3vsmWK`U`+{KIK%C1#L&gxMfq`@~`gH6*RmgevnzPE~%l=+vS;{iXp2V}g`fD$n z@`J7JzF9xUbhELX2ntd@b@na&w%`p7j&-+bP_%T8=(FGQ6QWGN%K2rS0Es1;Xz*B} zBK;{YdNZIdg-7a%rE6XK%dSvtbXtj+6l05Cy>vq5y=MQFC4NG-p93Qux^Pf=Q~&P| zvK#sW1)^alX^Z8GJJYnL$De(Rkj-+bFQzhSCL$WVYR6HQL>quf|KpAUfPreDgW}>^ zukZ$kgTNc8-Y8&!$0%Za#QhF1>aejbYgo2xvL%!vVoh&i<11snBX;<>_?aW-l%JN`&N!n-4eN-nOOuY@OWxWZ?xnW=kqN0#W5T}yhw^dZZ zdT^pRe?9l0N4RbMwjBb2;@lPVih#qd*{CR@lO_L_HOCi^$t|!_dV3rZNy$euIGKZAHvCz&`g8 zluXywBDS*D%2g(#U}M4mpk830V6)kl;y~^Q5kzS#b*ku`*agQ7xS*W``LPZ(2O~j! z0V0ey^0|ADxhAY&Cg0?cgAqx!RIm<=9vq%-Rx^O`7^>x4lzQ&>-yV!{!eg+*dDlAtDB=F`! z?Tz9=bvN$+IZ}!Uw(JPXcrw1EpYyr}_nG=(F>l8QUg)RQZRd36wHWMz{V_ zn)3G@fZyIprDSY$Bpl1%v0R3NK%pqBo0#V3hmRHVA6H9o3|pP0FW+?JoBS>b9t3!*{M$Q6xP0n)6Q?M9^{`@9U8+CQ&{}IIB8wA%df+omyY% zn+mT5R<7^Sr<<3Kgt4^Vj2^or_csvWpPvBj-YVW)p6am-T8%y$c`7y!wtvT3Klco0 zKe!YGAACHvD0dM|pJQU0lGV0h-_uI#EoCVQMZ8EOS8&5p68A%l5fMmUFdb`L=u-yw zhh?h#KMV$CnH#piJiOM0o31m2f(B@f(ka*-AZu(OP8}!*P5pho__q`CwJr<&(@<}Lh5T1PUjmi!w)?hu1 z#5a5=O8{ON+J+w}2!&f)MzE)9qRyp}4R&*XPYV^vT!Tkj;da~Zqr z9x7WOkzBG*+M9xDnv&cape6EM$#sI)Bl>fNoZ#=;CIc1T$ySi!X4G@s0o=eDSv6%f z%W%g!1&Pg__Jumyd1t#f%U6#zJrMndNFjAz<7JM(o0@oDJ%gR$mNy10(?j?m&Ux?0 z?La{_jbVe|2B|E$$9ZyZp*4~_p-QLJ5#ni8q(reStdriJ>j8Iw#@dkH5mG1j?-^Np zW(3{ojGSldae$y_QYD`aCN>#O-J76|6oM%m?9&JS|4c)ufu`h&ylfhr6s|;D!SZhz z(2qsc97HTUI2)v3$qNx93Q8?`oz1#WuZ&nkva|Zv#&5S(!c~<*e+$q!sjZ12OMa-= z{=QW`(*N*ve)Sisv+$<@6dJ)Q>Ma#2DDLR8sL>2N2r2=wjk3SOcUWsjZ>6%iAk`e- zjE1wiC^inS25I50z|t6WVCgt0fo4*pU?oT>Rr=O(!tfL}D|3OlY(KsBspzoeQ>RaS*;T}riFSKW-PpA)2xHQurCP(jURJF7JW+n>{$B4(3djy zdm@U*MFVG=e&)ahNXMndp3By^FC}(7A2{7}SXlwnMML1l;mi%-+ctNpY3;eZC%@@R z^}Zu^I5RBjj%VhrF_%{>y{3-o-rsCWoeVcE4RnKsq|}l#4vx4NX`@_!xQ|enAx%2#2SfXyV11K6|B2C1Z$NM%|H)C_`4p1OaSE;=H zbl^xS3~F=Pf@pYIB2V>sh>?GM5aerfNw)9}rD!ZEYvH%z8l7hl=&~K&GM=G1ERD8t zqGtv$t7G#oqC3}oNjU|kn3ObX!5V-i;ic!S!Nhph?mNL=Zx2Mjq7S8+3=gY#Q z-Yn|bJa}@o#GSxW0czHCEzENj*%n0B*GE`Q*GgcX)fu&@q9&FmIX1HX{;YogW1-tn z0%wfq4p3GM`des2`P#&@8+-s}h#w7XjG%14E}L8PSf96zVk-OF8Wv-z zCQ3!n!=`P~RK0Th<>~>1F#CJruFUZyRpGI%5rfPKAD_|Ro3mRr9)Q2n+7;4~g0~?? z=NV?pe00p%a3x{5g2$7Qw2Ad!s-Ec2>~MCU*~zT6sxK%Tn1%Ub{{7UTPIf80P3$0u z6Y+u=s*`3B=5B-OsJ=Zi+)GWzW-JBbg|nf^RG(yZnUHQe9;a6Y_n)_lw!BExhsw^_5r22KJe6uF7K zu5@OkFQ3RaLlBCJzpo4yk0uwR(fM>_5x3avqEo3%CgRTlDb&n^_KmA#4U$vprG?VX z`CjV&o=JS4ydrA2G-)fh_k3-jw2j$L9|{qwn{gG2_I69qhw3qxtAo|Yy=JTfr=<9F zxFo9oZs>7l(|hzmGK#g&W_;?tQT>RJ8*VsKQ*{>UaWy!meuw4Idvk^S0JC26pJCEd z^$(jhFP~%6h|%?aFpFPD>h1+n$F$r_`v^ZK z1=FQF03D@j#w3GbL^)?fFtRcjwwTraW11G)#b>y_A+8i3tYzBH27YCgE`=ZsX>20AR5oGZs)*@aKCkU(31^bcE{6D0=~)?`Wr0UYV>s7g0eg_PZp# zch^=Ih#YQLYKv{qThZdux)3U2J+JtX#CRUl;Z#7Z)w?i+BpyMJSSysulan!$6wr@n3X}FVJkGsK=C!$Kg`aT-LHI)9sX|WnUGBEkqH#r&&S* zwO)lh6lrBFu~$A=fI8}EtROpVc#0-mk`lkypwJ22!RGq4V_;ctEAAtYIGE3ByFnyd zVAf~6%xaBgYv!-)UM$0-MRA3M%xN8$KTw3?=obNV7jfKMpKhSb4=b(h&*?ZcnU)Zx z#I}TBrmN#ycbqA`p_D>SVj+o{38M>i@n%V0!6p5Su)s| z2ssr~83xI7jY!KhaJ5I`B`%PU06E3|Yzuu4V%=*@3UJVfHJm2{$oMeR33@dvicZ@*hX}*D%k({$&qGg(MHYOQ8 z>a*YYQL)cPV)ZpZ5T8j`>l)>g@^ec-W$Z65*;BYnp^))M(dQx)%bWXUIEvMexVmqd)BC@fT*UUbdqE}N)+ZA34w z;jZ}>iIXhv+LaF!jy(|#;%@TKGq_vhBy#ICz*+f@$#Dx=oS4Tk>X zjGGCxBk+EGwO_Y_k0)Au2Oz#58S;S!|2WXvkq@{L38`=U6#;$;hh!FCdVSt3yU&E_ zd}uFp+0_F`Yz+Vo3f(hBdosXjQ#NYJ)Xu07`17j3=AQDMK(P=@U9Ks{fbx9xGRNTF zlKheZjn=+D5!CDJr|s;ig|99I2Lq#*49&lKA#7z7EWdO>z? zStf^dOpXYLLWaY9ntW^Ss=p{dyAyI4f>`BDhFCy(44z! z5&VJo+2)^&T0@u)CsN+hxAp1otIhX<=8?vZa~5$_50HYI&At(FQmH}li~GCMJ`c+V zz!h{wZ2bY|d4BK36qv>B9Ex#@pF*1lNsUO4Hwp^X*=^u<}wE|Bn8{ae(W_ z`}ek1A$yCeT--5bY@&IRx>rzGua!|V%C7jDm(!}NZnGUn+WmF7-mmm>CZ**tvUaR4 zFO=;oF)8QVItE6w`Y?#PmJSE#)^f42M&&J z#Ko+kh>Ea^z`#fB38o(;t?5`<54NnB?qT_I23Pz^6mA8dM9jK3(pJy8;ve|?`gtyT zhUSa&>_XVi9k}p#d0_SnWRd}?$UV=dn?pL|`XL#AeoWaQrhYn-hHQ^4=Or)&Gr|O7f&1(k-Gm+0Fnml=0LOg@7q<(Xq)6-qJ zsNDhfqB)?3=_DwHxRknW390CFped-+7`T|p3y(}=NZkxjK-rtp%-wXzkKix=0)cN7 z4|JSJ@!4vTIV1rxb6vnW?V|<~+Yueh+#xFJdI#Q(uPQvvRodKVTskbu0a4ErIaKTP zBA{8ZT7;m-il7geIAFjS{+VRmdg#+~&qI534W%ZS3k5(FE6CZohE3zUa(%>i!i{hM z!=3oU1vq&d1F5H{Kj4VY+G^3IgP$Re4c?}`Z%qyxeVhRh?Y#*XJ!Mz%SpoCU?4|bx zu3flp$!Pz8#RWyK5n)8T8=nr|WM&mff>An%T z#vc2KI)<_$xg2f?et`ZyhbZuQOUjFLj;ZY!DPyW>Q$EYIOvm{c@MaceaR=bFcOhcd zb&shGoe8a_4Q}jypMY+I=oG3Ub0`BpO#_Vkvt2bOBJI(&4{a1Rz3F5GS`%8Xu9lbt zm3>#R2-dHwx?*Lcv1y7%lj~1Vow8o?)jYcb?WUu#+Sy}Z$`a+8`a`AZ)#ohEWk(jg z0AE9CymN_`cJ{w2eKD3&HU4h+yg=$ zzrODaa~nVDAsz#Ztm)goKn+3i+&N!>iIsARFA&7dA6N5P+oa12Xx-6dyqIGqHyCSeyc;*6XM^J%^hWwk`d6YTBG(45w%RqD*@(~^l{>#Az_e8^iMsI zQVfWF>am;;3+7{t(03h)^c7t&3cD+Idu+E%@MB}&i-%-_1 zmi!KXM5oO*Ajd7z^zHz$8CEe|4$ew)XK6`aF#i^+d5Y1eDoWwIJb#3mIg7F?)rsNS z6))Q$jLA7UWL;ahI|38dg@Y+N+Ysg$b8y$N@SJn$Bp3p=~{3X}~a(LLkmKzR~DUzwZN=zfTslewbK-I*>dP-_#YV`Zr zeA8a^+bab3uwR!|nP3C6$O`P#Hw1N7^9_cyCm5s?Ha;RU2EDjA^vzwwn9sE@-2&PO zL`Qx4=N-h#y|{F2G(^@Uu*2u}}u?PvW z0n@e#$@T5047C0Grg6%oKa+&M3qGQ`G@n?>sE1UC-N(WjTTHQlR7p9#?Gk+Vekw2v zqvQF~9Af1YhI);A!Dr+CyFL7Bxf)#Zi%V|4DS1cZaC9*`olk%L(1Ikfx&6mx1Vvz# zM8Lbxf}f-=7tP*Q=<7?~r)yR@JkpH|6aupUW@b!e5cBFi?@2oSMi8I0hl{)WuHM0l zPe4u6TyMZiWt;oz8)K5B@IbzR{!}S9%bQOn_;Lj}T82t*E>G#zsskTA+Z8zJ!Oi|E z^eMVw)6s(>bG>aNcP!Y#o6CgDgysIXOf;H_X0UJlQSaQ~31}{kx8XByrg$Nm`}ZTf z8J--HxPhH~vq``)l8``Zm+=|10*|yJrM5IOhpd*%PYMGfo zz}7rJEF&>FiFhGqoPQo(Rbqa^)vj@3k?NMU87=-1a*9t9;!jJK#rGqWs__kn`pySj ztA_0vUsU}{j;BV8MtxOdd+wof2iwsPN&9Xj1M=t7q+>7C7>a~~hTxjH_g0`oAnnm{ zGjn~Oxr^Ep0mEKoYXonz8Y=vX1x9%UtLxFP;2Hec*as@rCDk-95rhe`N>Eh2o0X6) z^Ly7L<2%0P&ELka{z*ftj2s6gvLy+ZY@Z)Gmv6c`!o33s4%$rR!L~IW6j@PDjR*d_ z?n;)nE@}<__t{wWj;Q*ELzs?} zW{#5NeXtGdL_;*T0&4zt!YG@5mzU8I8~;4QiOTe!Iotd|TSpn=`MM2AEF|^#(2Vrc zV6lq=vs+uOO6hV??PE&M0N&VP&#D&#yg`Fm125Y+IZ6tNAg+>|&H8aP8YwqYe^$U| zN!>B|Jd)6KVoqw;xw@B$^ZIAHt1Lz%6D|qrCAakpW@Gaj`uatD>VR}<|8QWyzMp4z z@M3yUq|qZjDojkbbZRb?`W^3XWGHDf(5bEG4siNVv8|vZstMxyF@3GF_lEdEoCp`I z3|+A#UYuixdpJ9xyL@CzTx3g=5u>=GJGzQjT{)i%3-h`DlyNq5hD%A*a34x2($!Wg zFiy^-a1BSBK>TO?mdI|NpQW#$y;~ATv+_$BAXfTdnP@u6x_#d(+fh}PN#B^Y{`1`M zMv3r@g|Xw5BFNlTRiMx5)v{6Z9pEuD#bOdQkJ0VkgfHDmk2)lJO`@&&@+ucl5i6#{ z`U>(~^XYh~kd_?ZVHRiJ6IXkmZQsE6tlaUF2BaAUL?SRYuuM|&j0I)$-^~FEhZwSVpa3}_q0Vv&RldGp8}g?U3^(C z%0=`az7~?UKx^h42O%2T_%1>4YsHnO<+)f_vQfoCH~BU zneXGvGD}>|bwW6f>4ah1=c&wm)@O{(d8ELBB^e^f``g z&3>U=SG`&RKlj&qn~~7X^o33H6`v>;-c!3@Aft!h*MTO?U@K!oT<{5rZ}MEKJxdet zu;vjg-_lek=q@-p?tb;8nH)pf)n^zzL7+)(08wz#c#*EUq<-RvZ5OA_Fu|?g165{` zb{bhRn=R6oc^KORWQVvWMRZ?`3Ldd{%JYk26qIW~Da#N~TWSo|l)4q0h|{?$>g|MBeGY6It;YqM4^34W<8;CsThDuGv`gImQb4&` zZuT>Yt;q^+5#>JX~xzW&;S8%?vh z^6EuNRarL|j|Ph>FhFhN>?H7}uN|~QPQW|yQIh13VddAkRN5>JC@6BVT62Ck_8Ui4?tI`S=PYXeb(kY{vEUp#6z%c!cH!>cY7pEZOyI{qREpuf4<(I+iz`vs_P5K+c7zaYN??c7}qh-VYZ{mE6( zGS~6_FVXz(6=j39A6XV=z?x&xLz5~3O zgt+Wkd1rFwn1=7!CuL4uRNx;LhbQ=7&DbVa*kFMt62uxH4c3Hj55HB`yn_7sfEJJO zr)-XeUs@BGT9gfx^$GU-x`O8?D)PhdyY2wtW|iw#t)HYh8?f7u)D8A+mb^>9y^!j! z*K|h^!B>56`uh#qpHo^fq&4C@EA1>7Q5i+3XjupwpgOH z1O9NpDr`nsNCOtCg-)z#_X=_ zFJ@>FN4jZ1D`SU5^5o1u*SI~TXr9ByPRLkN<`!jCu+60#3$faM-;u$apzK>(kla=E1Fk+%3{eD+yI1IR-vP89sJAMU4y!n&J^GU%@ri~V z+698^V)CLjWSbNxW9hmbt3;wtIQ_rPLSySC zQ1)1oy1HM_Bae`0bk$+-v#wJf4j6~QAv`=hSRkmN=9#0(&j5GB$VW24kKZqvj7$R~ zwo?a)ACQw;N9P2~w*!B9E)rOakQ`0dBR;uly*$m19EH&$DH#yRFt~=^R$vsv5Poa?Oj_Aap227&mQ_HJv%=G6Aph)}S*m~z zs{k1CJ($hn083+W>=ca{jP>~FT^ICF>QlwIb{(G8S^J6!jmL(C^{hvB2<=pc#b^Pg z3hsbW)7Ir<%^`Fd;kQgra;nc^jk(>h5BT9+J&Y(~tRAR^)qKINdSo|)b=ikfZ6<$$KWH>=B--mXA zd8TAJk2PxB?*LIQ+7zi5p@!y}UG#`G@1A$!+Q|&=8s@P&`KsJlQ}}WB#Koqiv=Af> zi(i^|M3#m^T0%?|2rX2q|6Vg3S`~b&Ci>;L0eXlwGE-H1-?ZiKh{xgX&uI#48?kVv zar5p*NNmO;{o;7lTPb|FFYwSL=H~T=sv}yYa^ik32YeQ0?f|{QV|LJ83=>F(scm7+b);{PcJ>x;_G5g9jg0ZTaV9r lsX^!ezn_E9>81N7Ht*})@8z~Mxxc*^@|EB}OZmIm{|_TR#o7P> literal 0 HcmV?d00001 diff --git a/docs/src/assets/demos/histogramEq/highHist.jpg b/docs/src/assets/demos/histogramEq/highHist.jpg new file mode 100644 index 0000000000000000000000000000000000000000..9c5668a40989e77b8d6f86d2a8efcbd93145cdb1 GIT binary patch literal 8120 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 literal 0 HcmV?d00001 diff --git a/docs/src/assets/demos/histogramEq/lightimage.png b/docs/src/assets/demos/histogramEq/lightimage.png new file mode 100644 index 0000000000000000000000000000000000000000..ca91f3e54a03017f4f0cbbf05e64660605634e92 GIT binary patch literal 37769 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 literal 0 HcmV?d00001 diff --git a/docs/src/assets/demos/histogramEq/lowHist.jpg b/docs/src/assets/demos/histogramEq/lowHist.jpg new file mode 100644 index 0000000000000000000000000000000000000000..ddceef29ce437aba3896a7884054f5d2ece685b3 GIT binary patch literal 3470 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 ``` [![svd](assets/demos/color_separations_svd.jpg)](@ref color_separations_svd) + ```@raw html
@@ -19,12 +20,31 @@ ```@raw html
+ +``` + +```@raw html +
+
+``` +[![con_bright_hist](assets/demos/histogramEq/highHist.jpg)](@ref contrast_brightness_histogram) + +```@raw html +
+
+``` +[Contrast and Brightness histograms](@ref contrast_brightness_histogram) +```@raw html +
+
+ ``` ```@raw html ``` + ## Contributions Users are invited to [contribute demonstrations of their own](https://github.com/JuliaImages/juliaimages.github.io). diff --git a/docs/src/demos/contrast_brightness_histogram.md b/docs/src/demos/contrast_brightness_histogram.md new file mode 100644 index 00000000..18ea430e --- /dev/null +++ b/docs/src/demos/contrast_brightness_histogram.md @@ -0,0 +1,104 @@ +# [Contrast and brightness analysis using histograms] (@id contrast_brightness_histogram) + +This demonstration will give you an idea on how to analyse and enhance the contrast and brightness of any image. We are using (Number of pixels vs. Pixel intensity) histogram of an +image. +For this demo you can download the images from [here](https://drive.google.com/open?id=1xoqiDgO3FCHqzKFaL0TOa45GiBgzuwbU). + +Ofcourse, a dark image and a bright image are visually different. +But, here, to appreciate the difference we will draw their respective histograms and observe the characterstics. +For example consider the below images - + +``` julia +using Images, ImageView, FileIO + +darkImg = load("histogramEq/darkimage.png") +brightImg = load("histogramEq/lightimage.png") + +imshow(darkImg) +imshow(brightImg) +``` +**Note : In case of error, try importing ImageMagick library before Images library.** + +| ![DI](../assets/demos/histogramEq/darkimage.png) | ![BI](../assets/demos/histogramEq/lightimage.png) | +|:------:|:---:| +| Dark | Bright | +Also, there can be some instances when we need a seperation mechanism for high +contrast image and a low contrast image in a code. + +``` julia +using Images, ImageView, FileIO + +highConImg = load("histogramEq/highcontrast.png") +lowConImg = load("histogramEq/lowcontrast.png") + +imshow(highConImg) +imshow(lowConImg) +``` + +| ![HC](../assets/demos/histogramEq/highcontrast.png) | ![LC](../assets/demos/histogramEq/lowcontrast.png) | +|:------:|:---:| +| High Contrast | Low Contrast | +Analysing histograms may help in such seperations also. + + +Let's have a look at the histograms of these images - +```julia +function plotHist(image) + + hist = imhist(image) + + column = maximum(hist[2]) + row = length(hist[1]) + 1 + img = fill(0, (column, row)) + + j = 0 + for i in hist[2] + for k in size(img)[1]- i + 1:size(img)[1] + img[k, j] = 1 + end + j = j + 1 + end + return img +end + +# to plot the histogram for dark image +img = plotHist(darkImg) +img = Gray.(img) +imshow(img) +``` + +| ![HC](../assets/demos/histogramEq/highHist.jpg) | ![LC](../assets/demos/histogramEq/lowHist.jpg) | +|:------:|:---:| +| High contrast | Low contrast | + +So, it may be noted from above that high contrast images have **roughly** +two distinct peaks in their histogram i.e., the foreground and +background can be said to be concentrated around two different intensities. More distinct +the peaks are more is the image contrast. + +| ![DI](../assets/demos/histogramEq/darkHist.jpg) | ![BI](../assets/demos/histogramEq/brightHist.jpg) | +|:------:|:---:| +| Dark image | Bright image | +Also, on observing the histograms for bright and dark image, we observe that +in the case of bright images the intensity is **roughly** concentrated in the high intensity region. +While, in the case of a dark image, the intensity is **roughly** concentrated in the low intensity region. + +Histograms can be very useful in many applications. One such use is described below. +We can enhance a low contrast image by using **Histogram Equalisation** method. +This method spreads out the most frequent intensity values in an image. + +``` julia +# equalising the low contrast image +equalised_img = histeq(lowConImg, 256) # 256 is the number of bins +imshow(equalised_img) +``` +| ![HE](../assets/demos/histogramEq/eqhist.jpg) | +|:------:| +| Enhanced image | + + + + + + +