ó  ‰\c@sqddlZddlZddlmZddlZddlmZmZddl m Z ddl m Z ddl mZmZddlmZddlZdd lmZejZed „eje ƒDƒƒZ ed e jƒƒe Zd „Zd „Zd„Zd„Zd„Zdefd„ƒYZ defd„ƒYZ!e"dkrmddl#Z#e#j$ƒndS(iÿÿÿÿN(t namedtuplei(tiot img_as_ubyte(tresize(t color_dict(tfile_or_url_contexttis_url(tImageCollection(trequestccs1|]'\}}|td„|DƒƒfVqdS(css#|]}td|dƒVqdS(iÿgà?N(tint(t.0tc((s5lib/python2.7/site-packages/skimage/novice/_novice.pys sN(ttuple(R tnametrgb((s5lib/python2.7/site-packages/skimage/novice/_novice.pys stcolorscCs t|ƒS(s0Return Picture object from the given image path.(tPicture(tpath((s5lib/python2.7/site-packages/skimage/novice/_novice.pytopenscCs³t|tƒot|ƒdks9tdj|ƒƒ‚ntd„|DƒƒrS|St|ƒ}xGt|ƒD]9\}}t|tƒrlt ||dƒ||<}qlqlWt|ƒS(s5Raise error if picture index is not a 2D index/slice.isExpected 2D index but got {0!r}css|]}t|tƒVqdS(N(t isinstanceR (R ti((s5lib/python2.7/site-packages/skimage/novice/_novice.pys !si( RR tlent IndexErrortformattalltlistt enumerateR tslice(tindexRt dim_slice((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt_verify_picture_indexs! "cCstj|dƒS(s.Return RGB array with first 2 axes transposed.iii(iii(tnpt transpose(tarray((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt rgb_transpose/scCst|ddd…ƒS(s@Return view of image transformed from array to Cartesian origin.Niÿÿÿÿ(R"(timage((s5lib/python2.7/site-packages/skimage/novice/_novice.pytarray_to_xy_origin4scCs#t|dd…ddd…fƒS(s@Return view of image transformed from Cartesian to array origin.Niÿÿÿÿ(R"(R#((s5lib/python2.7/site-packages/skimage/novice/_novice.pytxy_to_array_origin9stPixelcBs"eZdZdd„Zed„ƒZed„ƒZed„ƒZejd„ƒZed„ƒZ e jd„ƒZ ed „ƒZ e jd „ƒZ ed „ƒZ e jd „ƒZ ed „ƒZ e jd„ƒZ ed„ƒZ e jd„ƒZ d„Zd„Zd„Zd„ZRS(söA single pixel in a Picture. Attributes ---------- pic : Picture The Picture object that this pixel references. array : array_like Byte array with raw image data (RGB). x : int Horizontal coordinate of this pixel (left = 0). y : int Vertical coordinate of this pixel (bottom = 0). rgb : tuple RGB tuple with red, green, and blue components (0-255) alpha : int Transparency component (0-255), 255 (opaque) by default iÿcCss||_||_||_|j|dƒ|_|j|dƒ|_|j|dƒ|_|j|ƒ|_dS(Niii(t_picturet_xt_yt _validatet_redt_greent_bluet_alpha(tselftpicR!txtyRtalpha((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt__init__Rs   cCs|jS(s@Horizontal location of this pixel in the parent image(left = 0).(R((R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR1[scCs|jS(sAVertical location of this pixel in the parent image (bottom = 0).(R)(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR2`scCs|jS(s'The red component of the pixel (0-255).(R+(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pytredescCs |j|ƒ|_|jƒdS(N(R*R+t _setpixel(R/tvalue((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR5jscCs|jS(s)The green component of the pixel (0-255).(R,(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pytgreenoscCs |j|ƒ|_|jƒdS(N(R*R,R6(R/R7((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR8tscCs|jS(s(The blue component of the pixel (0-255).(R-(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pytblueyscCs |j|ƒ|_|jƒdS(N(R*R-R6(R/R7((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR9~scCs|jS(s0The transparency component of the pixel (0-255).(R.(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR3ƒscCs |j|ƒ|_|jƒdS(N(R*R.R6(R/R7((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR3ˆscCs|j|j|jfS(s7The RGB color components of the pixel (3 values 0-255).(R5R8R9(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRscs]t|ƒdkr|ˆ_n;‡fd†|Dƒ\ˆ_ˆ_ˆ_dˆ_ˆjƒdS(Nic3s|]}ˆj|ƒVqdS(N(R*(R tv(R/(s5lib/python2.7/site-packages/skimage/novice/_novice.pys ˜siÿ(RtrgbaR+R,R-R.R6(R/R7((R/s5lib/python2.7/site-packages/skimage/novice/_novice.pyR’s  ( cCs|j|j|j|jfS(sYThe RGB color and transparency components of the pixel (4 values 0-255). (R5R8R9R3(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR;œscs<‡fd†|Dƒ\ˆ_ˆ_ˆ_ˆ_ˆjƒdS(Nc3s|]}ˆj|ƒVqdS(N(R*(R R:(R/(s5lib/python2.7/site-packages/skimage/novice/_novice.pys ¦s(R+R,R-R.R6(R/R7((R/s5lib/python2.7/site-packages/skimage/novice/_novice.pyR;£s.cCsgy4t|ƒ}|dks'|dkr3tƒ‚nWn,tk rbd}t|j|ƒƒ‚nX|S(s-Verifies that the pixel value is in [0, 255].iiÿs;Expected an integer between 0 and 255, but got {0} instead!(R t ValueErrorR(R/R7tmsg((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR*©s  cCs0|j|jj|j|jf<|jjƒdS(N(R;R'txy_arrayR(R)t_array_modified(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR6µscCs#t|tƒr|j|jkSdS(N(RR&R;(R/tother((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt__eq__ºscCs+|j|j|j|jf}dj|ŒS(Ns.Pixel(red={0}, green={1}, blue={2}, alpha={3})(R5R8R9R3R(R/targs((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt__repr__¾s(t__name__t __module__t__doc__R4tpropertyR1R2R5tsetterR8R9R3RR;R*R6RARC(((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR&>s(    RcBsZeZdZd-d-d-d„Zedd„ƒZed„ƒZej d„ƒZed„ƒZ e j d„ƒZ d„Z d „Z ed „ƒZ ed „ƒZd „Zed „ƒZed„ƒZej d„ƒZed„ƒZej d„ƒZed„ƒZej d„ƒZd„Zd„Zd„Zd„Zd„Zed„ƒZej d„ƒZed„ƒZej d„ƒZed„ƒZej d„ƒZed„ƒZej d „ƒZed!„ƒZej d"„ƒZed#„ƒZej d$„ƒZd%„Zd&„Z d'„Z!d(„Z"d)„Z#d*„Z$d+„Z%d,„Z&RS(.sŠA 2-D picture made up of pixels. Attributes ---------- path : str Path to an image file to load / URL of an image array : array Raw RGB or RGBA image data [0-255], with origin at top-left. xy_array : array Raw RGB or RGBA image data [0-255], with origin at bottom-left. Examples -------- Load an image from a file: >>> from skimage import novice >>> from skimage import data >>> picture = novice.open(data.data_dir + '/chelsea.png') Load an image from a URL (the URL must start with ``http(s)://`` or ``ftp(s)://``): >>> picture = novice.open('https://scikit-image.org/_static/img/logo.png') # doctest: +SKIP Create a blank 100 pixel wide, 200 pixel tall white image: >>> pic = Picture.from_size((100, 200), color=(255, 255, 255)) Use numpy to make an RGB byte array (shape is height x width x 3): >>> import numpy as np >>> data = np.zeros(shape=(200, 100, 3), dtype=np.uint8) >>> data[:, :, 0] = 255 # Set red component to maximum >>> pic = Picture(array=data) Get the bottom-left pixel: >>> pic[0, 0] Pixel(red=255, green=0, blue=0, alpha=255) Get the top row of the picture: >>> pic[:, pic.height-1] Picture(100 x 1) Set the bottom-left pixel to black: >>> pic[0, 0] = (0, 0, 0) Set the top row to red: >>> pic[:, pic.height-1] = (255, 0, 0) cCsWt|_d|_d|_tg|||gD]}|dk r.|^q.ƒ}|dkrnd}t|ƒn¨|dk ræt|ƒs›tj j |ƒ}n||_t |ƒ1}t t j|ƒƒ|_tj|ƒ|_WdQXn0|dk rþ||_n|dk r||_n|jjddkrStj|jdddddƒ|_ndS( Nis:Must provide a single keyword arg (path, array, xy_array).iÿÿÿÿitvaluesiÿtaxisi(tFalset _modifiedtNonet_patht_formatRR<RtosRtabspathRRRtimreadR!timghdrtwhatR>tshapeRtinsert(R/RR!R>tatn_argsR=tcontext((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR4ûs(   4         tblackcCs­t|tjƒrt|}nt|ƒt|ƒf}tj|dtjƒ}tj |dtjƒ|}|j ddkr tj |dddddƒ}nt d|ƒS( sJReturn a Picture of the specified size and a uniform color. Parameters ---------- size : tuple Width and height of the picture in pixels. color : tuple or str RGB or RGBA tuple with the fill color for the picture [0-255] or a valid key in `color_dict`. tdtypeiÿÿÿÿiRIiÿRJiR!( Rtsixt string_typesRR RRR!tuint8tonesRURVR(tsizetcolortrgb_sizeR!((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt from_sizes  !cCs|jS(s!Image data stored as numpy array.(t_array(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR!,scCs=|jtjƒ|_t|jƒ|_|jjƒ|_dS(N(tastypeRR^RdR$t _xy_arraytcopyt _array_backup(R/R!((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR!1scCs|jS(s@Image data stored as numpy array with origin at the bottom-left.(Rf(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR>7scCs||_t|ƒ|_dS(N(RfR%Rd(R/R!((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR><s cCs°|jjdkri|jjddkritjj|ƒdjƒdkri|jddd…f|_ntj||jƒt |_ tjj |ƒ|_ t j|ƒ|_dS( sªSaves the picture to the given path. Parameters ---------- path : str Path (with file extension) where the picture is saved. iiÿÿÿÿis.jpgs.jpeg.N(s.jpgs.jpeg(R!tndimRURPRtsplitexttlowerRtimsaveRKRLRQRNRSRTRO(R/R((s5lib/python2.7/site-packages/skimage/novice/_novice.pytsaveAs(" cCs|j|_dS(sDReset image to its original state, removing modifications. N(RhR!(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pytresetQscCs|jS(sThe path to the picture.(RN(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRWscCs|jS(s True if the picture has changed.(RL(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pytmodified\scCst|_d|_dS(N(tTrueRLRMRN(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR?as cCs|jS(s The image format of the picture.(RO(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRescCs|jjd S(s(The size (width, height) of the picture.i(R>RU(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR`jsc Cs–|d|jks&|d|jkr’t|dƒt|dƒf}t|j|dddtdddtƒ}|jtj ƒ|_|j ƒndS(Niitordertpreserve_rangetmodetconstantt anti_aliasing( twidththeightR RR!RpRKReRR^R?(R/R7tnew_sizet new_array((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR`os&   cCs |jdS(sThe width of the picture.i(R`(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRv|scCs||jf|_dS(N(RwR`(R/R7((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRvscCs |jdS(sThe height of the picture.i(R`(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRw…scCs|j|f|_dS(N(RvR`(R/R7((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRwŠscCstj|jƒtjƒdS(sDisplay the image.N(RtimshowR!tshow(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR{ŽscsN|j|jg‰tddgd‡fd†ƒ}tjˆƒtjƒdS(s,Compare the image to its unmodified version.iit load_funccsˆ|S(N((R1(timages(s5lib/python2.7/site-packages/skimage/novice/_novice.pyt–sN(RhR!RRtimshow_collectionR{(R/tic((R}s5lib/python2.7/site-packages/skimage/novice/_novice.pytcompare“s! cCs,|j||f}t||j|||ƒS(s0Create a Pixel object for a given x, y location.(R>R&R!(R/R1R2R((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt _makepixelšscCs |jdd…dd…|fS(s<Return a specific dimension out of the raw image data slice.N(Rd(R/tchannel((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt _get_channelŸscCs&||jdd…dd…|f(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRËscCs,||jdd…dd…dd…f(R/R7((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRÐscCs|jS(s8The RGBA color components of the pixel (4 values 0-255).(R>(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR;ÔscCs||j(dS(N(R>(R/R7((s5lib/python2.7/site-packages/skimage/novice/_novice.pyR;ÙsccsIxBt|jƒD]1}x(t|jƒD]}|j||ƒVq&WqWdS(s&Iterates over all pixels in the image.N(trangeRvRwR‚(R/R1R2((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt__iter__ÝscCsGt|ƒ}td„|Dƒƒr/|j|ŒStd|j|ƒSdS(s6Return `Picture`s for slices and `Pixel`s for indexes.css|]}t|tƒVqdS(N(RR (R R((s5lib/python2.7/site-packages/skimage/novice/_novice.pys æsR>N(RRR‚RR>(R/txy_index((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt __getitem__ãs  cCsgt|ƒ}t|tƒr+|||_n.t|tƒrM|j|j|t TypeErrorR?(R/R‰R7((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt __setitem__ës  cCs4t|tƒstƒ‚ntj|j|jkƒS(N(RRtNotImplementedErrorRRR!(R/R@((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRAõs cCsdj|jŒS(NsPicture({0} x {1})(RR`(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRCúscCs |jdƒS(Ntpng(t_repr_image_format(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt _repr_png_ýscCs |jdƒS(Ntjpeg(R(R/((s5lib/python2.7/site-packages/skimage/novice/_novice.pyt _repr_jpeg_scCs?tjƒ}tj||jd|ƒ|jƒ}|jƒ|S(Nt format_str(R\tBytesIORRlR!tgetvaluetclose(R/R“t str_buffert return_str((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRs    N('RDRERFRMR4t staticmethodRcRGR!RHR>RmRnRRoR?RR`RvRwR{RR‚R„R…R5R8R9R3RR;RˆRŠRŒRARCRR’R(((s5lib/python2.7/site-packages/skimage/novice/_novice.pyRÃsZ6               t__main__(%RPRSt collectionsRtnumpyRtRRt transformRRaRtio.utilRRt io.collectionRR\tsix.moves.urllibRturlopentdictt iteritemstkeysRRRR"R$R%tobjectR&RRDtdoctestttestmod(((s5lib/python2.7/site-packages/skimage/novice/_novice.pyts2           …ÿI