Vf%"0dZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddlZ ddl ZddlZddlmZmZddl mZddlmZmZmZmZmZddlmZddlmZdd lmZdd l m!Z"dd l#m$Z$m%Z%dZ&ejNejPd ejNejPd dejNejPddZ)dZ*dZ+ejXZ-dZ.dZ/d5dZ0d6dZ1d6dZ2dZ3dZ4dZ5d7dZ6ej0jnd8iejpGddZ9GddZ:Gd d!Z;Gd"d#Z<Gd$d%Z=d&Z>d9d'Z?d:d(Z@d)ZAd;d*ZBGd+d,ZCGd-d.ZDd/ZEdd3ZId4ZJy)?a  plotly ====== A module that contains the plotly class, a liaison between the user and ploty's servers. 1. get DEFAULT_PLOT_OPTIONS for options 2. update plot_options with .plotly/ dir 3. update plot_options with _plot_options 4. update plot_options with kwargs! )absolute_importN)CompoundValidatoris_array)PlotlyJSONEncoder)filessessiontoolsutils exceptions)v2)chunked_requests)Grid)dashboard_objs) get_configget_credentialsworld_readable auto_openTsharing)rrvalidaterzKWhoops, sharing can only be set to either 'public', 'private', or 'secret'.c tj||fi| tjj y#t j $r tj jdwxYw)NzSign in failed.) rsign_inr userscurrentr PlotlyRequestError _plotly_utils PlotlyError)usernameapi_keykwargss c/var/www/html/software/conda/envs/catlas/lib/python3.12/site-packages/chart_studio/plotly/plotly.pyrr<s\ OOHg00F   ( (F&&223DEEFs 83A+c tjt}tj}t j }tj|}|||fD],}tj|tj|.i}|j||j||j||j||jDcic]\}}||vs|dk(r||}}}|Scc}}w)ai Given some plot_options as part of a plot call, decide on final options. Precedence: 1 - Start with DEFAULT_PLOT_OPTIONS 2 - Update each key with ~/.plotly/.config options (tls.get_config) 3 - Update each key with session plot options (set by py.sign_in) 4 - Update each key with plot, iplot call signature options filename) copydeepcopyDEFAULT_PLOT_OPTIONSr get_config_filerget_session_plot_optionsr ,validate_world_readable_and_sharing_settingsset_sharing_and_world_readableupdateitems)plot_options_from_argsdefault_plot_options file_optionssession_options option_setuser_plot_optionskvs r _plot_option_logicr4Is ==)=>((*L668O!]]+AB. M9  :::F ,,Z8912\*_-34&++- Aq $ $Z 1  s$C?c ddlm}m}d|vrd|d<t|fi|}t |t r/|j di}t ||r:|j}n)t ||r|jj}ni}t }|j dd|d<|j dd |d< t|dt|dd z|d< t|dt|dd z|d<tj|fi|S#ttf$rYJwxYw#ttf$rY| dk(rd| d<n3| dk(r d| d<d| d<n#tj j#t$t'|\}}t |dkDrE| sd}n| r | d z| zdz}n| dz}t(j+||| ddt-|||| d<t/| d}| dk(r|ddd dz|dz}n|d}|jdd}|r t1||S#t$rYwxYw)aCreate a unique url for this plot in Plotly and optionally open url. plot_options keyword arguments: filename (string) -- the name that will be associated with this figure auto_open (default=True) -- Toggle browser options True: open this plot in a new browser tab False: do not open plot in the browser, but do return the unique url sharing ('public' | 'private' | 'secret') -- Toggle who can view this graph - 'public': Anyone can view this graph. It will appear in your profile and can appear in search engines. You do not need to be logged in to Plotly to view this chart. - 'private': Only you can view this plot. It will not appear in the Plotly feed, your profile, or search engines. You must be logged in to Plotly to view this graph. You can privately share this graph with other Plotly users in your online Plotly account and they will need to be logged in to view this plot. - 'secret': Anyone with this secret link can view this chart. It will not appear in the Plotly feed, your profile, or search engines. If it is embedded inside a webpage or an IPython notebook, anybody who is viewing that page will be able to view the graph. You do not need to be logged in to view this plot. world_readable (default=True) -- Deprecated: use "sharing". Make this figure private/public rNdatatype scattergli@aUWoah there! Look at all those points! Due to browser limitations, the Plotly SVG drawing functions have a hard time graphing more than 500k data points for line charts, or 40k points for other types of charts. Here are some suggestions: (1) Use the `plotly.graph_objs.Scattergl` trace object to generate a WebGl graph. (2) Trying using the image API to return an image instead of a graph URL (3) Use matplotlib (4) See if you can create your visualization with fewer data points If the visualization you're using aggregates points (e.g., box plot, histogram, etc.) you can disregard this warning.T)figurerr"/ parent_pathrpublicrprivateFsecretshare_key_enabled_grid)gridr"rrrSr@web_url ?share_key= share_keyr) plotly.toolsr !return_figure_from_figure_or_datalistr+lenwarningswarnrHr4rCsplitjoinfile_ops ensure_dirsrr rSHARING_ERROR_MSG_extract_grid_from_fig_likegrid_opsupload_set_grid_column_references_create_or_update _open_url)rJrrKplotlyrSentrykeyvalmsgpayloadr"pathsrVrr] grid_filename file_infor^rs r r@r@s: \\ ; ;NH UF eO%-;"> U[[]+ HC s8e#2$MM#&+ 8&l3L 48G D1H B<3 "~Hs#hhuQr{+ 9    -%0GM "&  y$/G($( ! I $) ! H $) !'+#$&&223DEE/v6LFD 4y1} M '#-87BM$w.M""#34   $FD1"!'62I(I&s+m;i >TTI&  d3I' N[  s%H HHc ddl}|jj|||}|r"t|tr|j |n!|t jjdt|fi|S)aReplot a matplotlib figure with plotly in IPython. This function: 1. converts the mpl figure into JSON (run help(plotly.tools.mpl_to_plotly)) 2. makes a request to Plotly to save this figure in your account 3. displays the image in your IPython output cell Positional arguments: fig -- a figure object from matplotlib Keyword arguments: resize (default=True) -- allow plotly to choose the figure size strip_style (default=False) -- allow plotly to choose style options update (default=None) -- update the resulting figure with an 'update' dictionary-like object resembling a plotly 'Figure' object Additional keyword arguments: plot_options -- run help(plotly.plotly.iplot) rNresize strip_stylev'update' must be dictionary-like and a valid plotly Figure object. Run 'help(plotly.graph_objs.Figure)' for more info.) rar mpl_to_plotlyrArBr*rr PlotlyGraphObjectErrorrNfigr}r~r*rKrrs r iplot_mplr/sq* ,, $ $S[ $ QC *VT* 6  &&== J    % %%c ddl}|jj|||}|r"t|tr|j |n!|t jjdt|fi|S)aReplot a matplotlib figure with plotly. This function: 1. converts the mpl figure into JSON (run help(plotly.tools.mpl_to_plotly)) 2. makes a request to Plotly to save this figure in your account 3. opens your figure in a browser tab OR returns the unique figure url Positional arguments: fig -- a figure object from matplotlib Keyword arguments: resize (default=True) -- allow plotly to choose the figure size strip_style (default=False) -- allow plotly to choose style options update (default=None) -- update the resulting figure with an 'update' dictionary-like object resembling a plotly 'Figure' object Additional keyword arguments: plot_options -- run help(plotly.plotly.plot) rNr|r) rar rrArBr*rr rr@rs r plot_mplrQsq* ,, $ $S[ $ QC *VT* 6  &&== J    $| $$rcd\}} |j|} |j|}||||<||||<yy#t$rY-wxYw#t$rY*wxYw)zSwap obj[key1] with obj[key2]NNN)popKeyError)objkey1key2val1val2s r _swap_keysrss{JD$ wwt} wwt} D  D         s :A AA AAcgd}|D]}t||d|d t|d}t|dd}|dD]}t||k7st|jd}t |Dcgc]}t |Dcgc]}dc}c}}|d<t |D]#} t |D]} || | |d| | <%ycc}wcc}}w#t tt f$rq} d} |dd} t|ddk(rd} n#t tf$rYnwxYw| r2tjdjt| Yd} ~ yYd} ~ yd} ~ wwxYw) z Swap x and y data and references))xy)x0y0)dxdy)xbinsybins)nbinsxnbinsy)autobinxautobiny)error_xerror_yrzFNTz~Data in this file required an 'xy' swap but the 'z' matrix in one of the data objects could not be transposed. Here's why: {}) rrdrHrranger IndexErrorrerfformatrepr) data_objswapsswaprowscolsrowrcccrrriiijjjerrrfs r _swap_xy_datars E/8T!Wd1g./8C=!8C=#$C= C3x4 LL ?DT{KuT{3!3K ; 6CT{ 6*+C&+ c"3' 6 64K i , }(8C=!Q&)$     MM#VDI.   se5C &C <C C C8C CC E%4E 7DE D$!E #D$$2E  E%c<t|tr6|jDcic]\}}t|t|c}}St|tr|Dcgc] }t|c}St|t r|j dS|Scc}}wcc}w)z6Convert unicode strings in JSON object to byte stringsutf-8)rArB iteritemsbyteifyrcunicodeencode)inputrtvalueelements r rrs|%?D?PQe gen,QQ E4 056W 66 E7 #||G$$ R6s BBcddl}td}||}|dt||k7r/tjj dj |||dz}|j|djdd}|j|djdd}n|} t|t|dkrtjj d d j ||}tjj|d } | j} tj r t#| } t%| dD]\} } t'| ddk(d| vd| vfr| j)d| d<| ddvrd| d<d| vrs| j)d| d<| ddk(r| ddk(r t+| | ddk(r? #-<0I#J . "-t4>>yy%%..}=FFW-t~~F&(@  rc |jjd|y#t$r tjj dwxYw)a  Keep stream alive. Streams will close after ~1 min of inactivity. If the interval between stream writes is > 30 seconds, you should consider adding a heartbeat between your stream.write() calls like so: >>> stream.heartbeat()   reconnect_ontStream has not been opened yet, cannot write to a closed connection. Call `open()` on the stream to open the stream.N)rwriteAttributeErrorrr r)rrs r heartbeatzStream.heartbeat|sL  LL  t,  ? **66B  s  )A cP|jy|jjSNF)r _isconnectedrs r connectedzStream.connecteds" << ||((**rcX|j}tjdi||_y)z Open streaming connection to plotly. For more help, see: `help(plotly.plotly.Stream)` or see examples and tutorials here: https://plotly.com/python/streaming/ N)rr rr)rrs r openz Stream.opens'224'..AA rNcddlm}t||r|j}nt j |}|j dd||jt|tj|t}|dz } |jj||y#t$r tj j#d wxYw) a Write to an open stream. Once you've instantiated a 'Stream' object with a 'stream_id', you can 'write' to it in real time. positional arguments: trace - A dict of properties to stream Some valid keys for trace dictionaries: 'x', 'y', 'text', 'z', 'marker', 'line' keyword arguments: layout (default=None) - A valid Layout object or dict with compatible properties Run help(plotly.graph_objs.Layout) Examples: Append a point to a scatter trace >>> write(dict(x=1, y=2)) Overwrite the x and y properties of a scatter trace >>> write(dict(x=[1, 2, 3], y=[10, 20, 30])) Append a point to a scatter trace and set the points text value >>> write(dict(x=1, y=2, text='scatter text')) Append a point to a scatter trace and set the points color >>> write(dict(x=1, y=3, marker=go.Marker(color='blue'))) Set a new z value array for a Heatmap trace >>> write(dict(z=[[1, 2, 3], [4, 5, 6]])) The connection to plotly's servers is checked before writing and reconnected if disconnected and if the response status code is in `reconnect_on`. For more help, see: `help(plotly.plotly.Stream)` or see examples and tutorials here: r) BaseTraceTyperQN)r9clsrrr)r?r rArDr#r$rr*rB_jsondumpsrrrrrr r)rtracer9rr  stream_objectjdatas r rz Stream.writesX 7 e] +!002M MM%0M &$'    V!4 5 M/@A    LL  u<  @ **66B  s B'')Cc |jjy#t$r tjj dwxYw)z Close the stream connection to plotly's streaming servers. For more help, see: `help(plotly.plotly.Stream)` or see examples and tutorials here: https://plotly.com/python/streaming/ zStream has not been opened yet.N)rcloserrr rrs r rz Stream.closesB  LL    **661  s )Ar )rWii)Nr)__name__ __module__ __qualname____doc__rrrr template_docr r&rrrpropertyrr rrr rr rr0sy@IJ%]%%@(=(=(=(?@ A 2$++ BDLrrcHeZdZdZeddZeddZe ddZy)imagezP Helper functions wrapped around plotly's static image generation api. Ncddl}|jj|d}|dvrtjj d| t |}||d}|||d<|||d <|||d <tjj|}|j} d | vr| d d vr |jSd | vrd | d vr|jdSyy#tjj dxYw)aDReturn a static image of the plot described by `figure_or_data`. positional arguments: - figure_or_data: The figure dict-like or data list-like object that describes a plotly figure. Same argument used in `py.plot`, `py.iplot`, see https://plotly.com/python for examples - format: 'png', 'svg', 'jpeg', 'pdf', 'emf' - width: output width - height: output height - scale: Increase the resolution of the image by `scale` amount (e.g. `3`) Only valid for PNG and JPEG images. example: ``` import plotly.plotly as py fig = {'data': [{'x': [1, 2, 3], 'y': [3, 1, 5], 'type': 'bar'}]} py.image.get(fig, 'png', scale=3) ``` rNT)pngsvgjpegpdfemfzInvalid format. This version of your Plotly-Python package currently only supports png, svg, jpeg, and pdf. Learn more about image exporting, and the currently supported file types here: https://plotly.com/python/static-image-export/z0Invalid scale parameter. Scale must be a number.)rSrr:r<scalez content-type)z image/pngz image/jpegzapplication/pdfz image/svg+xmlz image/emfrr ) rar rbrr rrEr imagescreaterrr) rJrr:r<r'rrrSrwrrs r rCz image.gets02 ??PTU = =**66A    e  $v6  $GG    &GH   $GG 99##G,"" W $)@E * ## # w &6W^5L+L==?7+ +,M &1 #..::Fs  C!C/c|dk(rtjjd|j|||||}ddlm}m}m} |dk(r|| |y|||y)a4Display a static image of the plot described by `figure_or_data` in an IPython Notebook. positional arguments: - figure_or_data: The figure dict-like or data list-like object that describes a plotly figure. Same argument used in `py.plot`, `py.iplot`, see https://plotly.com/python for examples - format: 'png', 'svg', 'jpeg', 'pdf' - width: output width - height: output height - scale: Increase the resolution of the image by `scale` amount Only valid for PNG and JPEG images. example: ``` import plotly.plotly as py fig = {'data': [{'x': [1, 2, 3], 'y': [3, 1, 5], 'type': 'bar'}]} py.image.ishow(fig, 'png', scale=3) r%zAw, snap! It's not currently possible to embed a pdf into an IPython notebook. You can save the pdf with the `image.save_as` or you can embed an png, jpeg, or svg.r)displayImageSVGr#N)rr rrCIPython.displayr+r,r-) rrJrr:r<r'imgr+r,r-s r ishowz image.ishowAsf, U?**66. ggnfeVUC77 U? CH  E#J rc tjj|\}}|s|s|dz }n|r|s|dd}n |s |r|d|zz }|j|||||} t |d} | j | | j y)a%Save a image of the plot described by `figure_or_data` locally as `filename`. Valid image formats are 'png', 'svg', 'jpeg', 'pdf' and 'emf'. The format is taken as the extension of the filename or as the supplied format. positional arguments: - figure_or_data: The figure dict-like or data list-like object that describes a plotly figure. Same argument used in `py.plot`, `py.iplot`, see https://plotly.com/python for examples - filename: The filepath to save the image to - format: 'png', 'svg', 'jpeg', 'pdf', 'emf' - width: output width - height: output height - scale: Increase the resolution of the image by `scale` amount Only valid for PNG and JPEG images. example: ``` import plotly.plotly as py fig = {'data': [{'x': [1, 2, 3], 'y': [3, 1, 5], 'type': 'bar'}]} py.image.save_as(fig, 'my_image.png', scale=3) ``` z.pngrN.wb)ospathsplitextrCr rr) rrJr"rr:r<r'baseextr/fs r save_asz image.save_asgs>gg&&x0 s6  H WF f $HggnfeVUC 4     r)r"NNN)NNNN) rrrr staticmethodrC classmethodr0r:r rr r r sJ @,@,D# # JSW**rr c0eZdZdZedZedZy)riz0 Interface to Plotly's File System API c\tjjd|i}|jS)as Create folder(s) specified by folder_path in your Plotly account. If the intermediate directories do not exist, they will be created. If they already exist, no error will be thrown. Mimics the shell's mkdir -p. Returns: - 200 if folders already existed, nothing was created - 201 if path was created Raises: - exceptions.PlotlyRequestError with status code 400 if the path already exists. Usage: >> mkdirs('new folder') >> mkdirs('existing folder/new folder') >> mkdirs('new/folder/path') r5)r foldersr) status_code)r folder_pathrs r mkdirszfile_ops.mkdirss)0::$$fk%:;###rc |j|y#tj$r}d|jvrn|Yd}~yd}~wwxYw)z Create folder(s) if they don't exist, but unlike mkdirs, doesn't raise an error if folder path already exist already existsN)rBr rmessage)rrAes r rjzfile_ops.ensure_dirssB   JJ{ #,, 199, sA=AN)rrrrr<rBrjr rr riris/ $$4  rriczeZdZdZedZedZe d dZed dZ ed dZ ed dZ y) rma4 Interface to Plotly's Grid API. Plotly Grids are Plotly's tabular data object, rendered in an online spreadsheet. Plotly graphs can be made from references of columns of Plotly grid objects. Free-form JSON Metadata can be saved with Plotly grids. To create a Plotly grid in your Plotly account from Python, see `grid_ops.upload`. To add rows or columns to an existing Plotly grid, see `grid_ops.append_rows` and `grid_ops.append_columns` respectively. To delete one of your grid objects, see `grid_ops.delete`. c|D]G}|D]@}|d|jk(sdj||d|_|j|BIy)Nname{0}:{1}uid)rIridremove)rrequest_columnsresponse_columnsgrid_idreq_colresp_cols r _fill_in_response_column_idsz%grid_ops._fill_in_response_column_idssW& 6G, 6F#w||3!*!1!1'8E?!KGJ$++H5 6 6rcF|rytjjd)NzaThis operation requires that the grid has already been uploaded to Plotly. Try `uploading` first.)rr r)rs r ensure_uploadedzgrid_ops.ensure_uploadeds&  &&22 0  rNc|j}|||d<||d}|r]|ddk(r|dd}|jd}dj|dd} |d}| dk7rtj | ||d<| r| |d<t |} | d } | d } | d } |j || | | |_|tj|| |r t| | S) av Upload a grid to your Plotly account with the specified filename. Positional arguments: - grid: A plotly.grid_objs.Grid object, call `help(plotly.grid_ops.Grid)` for more info. - filename: Name of the grid to be saved in your Plotly account. To save a grid in a folder in your Plotly account, separate specify a filename with folders and filename separated by backslashes (`/`). If a grid, plot, or folder already exists with the same filename, a `plotly.exceptions.RequestError` will be thrown with status_code 409. If filename is None, and randomly generated filename will be used. Optional keyword arguments: - world_readable (default=True): make this grid publically (True) or privately (False) viewable. - auto_open (default=True): Automatically open this grid in the browser (True) - meta (default=None): Optional Metadata to associate with this grid. Metadata is any arbitrary JSON-encodable object, for example: `{"experiment name": "GaAs"}` Filenames must be unique. To overwrite a grid with the same filename, you'll first have to delete the grid with the blocking name. See `plotly.plotly.grid_ops.delete`. Usage example 1: Upload a plotly grid ``` from plotly.grid_objs import Grid, Column import plotly.plotly as py column_1 = Column([1, 2, 3], 'time') column_2 = Column([4, 2, 5], 'voltage') grid = Grid([column_1, column_2]) py.grid_ops.upload(grid, 'time vs voltage') ``` Usage example 2: Make a graph based with data that is sourced from a newly uploaded Plotly grid ``` import plotly.plotly as py from plotly.grid_objs import Grid, Column from plotly.graph_objs import Scatter # Upload a grid column_1 = Column([1, 2, 3], 'time') column_2 = Column([4, 2, 5], 'voltage') grid = Grid([column_1, column_2]) py.grid_ops.upload(grid, 'time vs voltage') # Build a Plotly graph object sourced from the # grid's columns trace = Scatter(xsrc=grid[0], ysrc=grid[1]) py.plot([trace], filename='graph from grid') ``` metadata)rPrrTrUrrWr"rVrrr^)r]) _to_plotly_grid_jsonrgrhrirj_create_or_overwrite_gridrSrLmeta_opsrnrq)rr]r"rrmeta grid_jsonrwrxrVrzrrr^s r rnzgrid_ops.uploads @--/  $(Ij !$G |s"#Ab>NN3'E((52;/KRyHb $$[1"*GJ )4 &-g6  I& ((tS9   OODtO ,  g rclt||}tj||Dcgc]}|j}}|r*|Dcgc]}|j}}|j |t j |}|r4tjj|} tj| dtj|ti} |} tjj!| | } | j#} |j%|| d| |r|j |yycc}wcc}w)a Append columns to a Plotly grid. `columns` is an iterable of plotly.grid_objs.Column objects and only one of `grid` and `grid_url` needs to specified. `grid` is a ploty.grid_objs.Grid object that has already been uploaded to plotly with the grid_ops.upload method. `grid_url` is a unique URL of a `grid` in your plotly account. Usage example 1: Upload a grid to Plotly, and then append a column ``` from plotly.grid_objs import Grid, Column import plotly.plotly as py column_1 = Column([1, 2, 3], 'time') grid = Grid([column_1]) py.grid_ops.upload(grid, 'time vs voltage') # append a column to the grid column_2 = Column([4, 2, 5], 'voltage') py.grid_ops.append_columns([column_2], grid=grid) ``` Usage example 2: Append a column to a grid that already exists on Plotly ``` from plotly.grid_objs import Grid, Column import plotly.plotly as py grid_url = 'https://plotly.com/~chris/3143' column_1 = Column([1, 2, 3], 'time') py.grid_ops.append_columns([column_1], grid_url=grid_url) ``` rrN)parse_grid_id_argsrmrUrIextendr get_first_duplicater NON_UNIQUE_COLUMN_MESSAGEr InputErrorrrrr grids col_createrrS)rcolumnsr]grid_urlrPc column_namesexisting_column_namesduplicate_namerbodyrrparsed_contents r append_columnszgrid_ops.append_columnsRs L%T84  ))0010 0 59$:QVV$: !$:    5 622<@ 66==nMC'', , G1BCD88&&sD1! ((.2H#N  KK  #1$:s D,D1c 4t||}tj||rt|Dcgc]}|c}}t |D]c\}}t||k7st j dj|t|t|dk(rdnd||dk(r dd|} tjj| d|i|rt|D cgc]} t| jc} } |D]M}| t|jz } t| D cgc]} d}} |jj|Ot|}t||D] \}}|jj|"y y cc}wcc} wcc} w) a Append rows to a Plotly grid. `rows` is an iterable of rows, where each row is a list of numbers, strings, or dates. The number of items in each row must be equal to the number of columns in the grid. If appending rows to a grid with columns of unequal length, Plotly will fill the columns with shorter length with empty strings. Only one of `grid` and `grid_url` needs to specified. `grid` is a ploty.grid_objs.Grid object that has already been uploaded to plotly with the grid_ops.upload method. `grid_url` is a unique URL of a `grid` in your plotly account. Usage example 1: Upload a grid to Plotly, and then append rows ``` from plotly.grid_objs import Grid, Column import plotly.plotly as py column_1 = Column([1, 2, 3], 'time') column_2 = Column([5, 2, 7], 'voltage') grid = Grid([column_1, column_2]) py.grid_ops.upload(grid, 'time vs voltage') # append a row to the grid row = [1, 5] py.grid_ops.append_rows([row], grid=grid) ``` Usage example 2: Append a row to a grid that already exists on Plotly ``` from plotly.grid_objs import Grid import plotly.plotly as py grid_url = 'https://plotly.com/~chris/3143' row = [1, 5] py.grid_ops.append_rows([row], grid=grid_url) ``` zThe number of entries in each row needs to equal the number of columns in the grid. Row {0} has {1} {2} but your grid has {3} {4}. rrsentriescolumnrerrWN)r^rmrUrdrr rbrr rcrmaxrPrr_zip)rrr]rfrPrp n_columnsrow_irrcollongest_column_length n_empty_rows_empty_string_rowscolumn_extensions local_columncolumn_extensions r append_rowszgrid_ops.append_rowssZ%T84  ) $7V78I'o  ss8y($//-.4V!H'*3x1}G)%(1QH .  =F .     S64.) $'$(G3SXX(G$H ! 64s6;;7GG 16|1D$EAR$E!$E ""#45 6 !$T 25d>rrrrrrr<rnr rr rZrZ s )?)?rrZc | |j}nd}||g}d}t||Dcgc] \}}| | }}}|stjdt |dkDrtjd|j }|dk(rvt jjjj|j} | jddjd d d \} } d j| | S|jScc}}w) z{ Return the grid_id from the non-None input argument. Raise an error if more than one argument was supplied. N)r]rfaOne of the two keyword arguments is required: `grid` or `grid_url` grid: a plotly.graph_objs.Grid object that has already been uploaded to Plotly. grid_url: the url where the grid can be accessed on Plotly, e.g. 'https://plotly.com/~chris/3043' rzCOnly one of `grid` or `grid_url` is required. You supplied both. rfrrWrUrrJ)rLrrr rbrdrrrrrrr5rrgr) r]rf id_from_gridargs arg_namesarg_nameargsupplied_arg_namessupplied_arg_namer5rrs r r^r^Es ww  ( #D$I'*)T&:"Xsco ## D    1 $## V  /224  *99##))228<AAD"&,,tR"8">">s"CAa"H J##J8 877N1s D D ctjjjj |}|j j ddj dd}|j j dd}dj||}ddd}tjj||}tjd tjj|jd }|s5|dz }|d k(rtj j#d t%|||d z|jdz} | S)zS Check that share key is enabled and update url to include the secret key rUr~rrTF)r[rr[2zuThe sharekey could not be enabled at this time so the graph is saved as private. Try again to save as 'secret' later.r_r`)rrrrrr5rgrr rr*timesleepretrieverrr radd_share_key_to_url) plot_urlattempturlsplitridlocalrrkrr[ url_share_keys r rrns# yy%%..x8H}}""3'*005a8Hmm!!#&q)G ..7 +C!% ?DxxsD)H  JJqM))#.3356IJ 1  b=**66L  Xw/},x}}{/KKM rctd|}tjj|}|j }|r|St ||S)a Returns the specified grid as a Grid instance or in JSON/dict form. :param (str) grid_url: The web_url which locates a Plotly grid. :param (bool) raw: if False, will output a Grid instance of the JSON grid being retrieved. If True, raw JSON will be returned. N)r^r rcrrr)rfrrrrls r get_gridrsE T8 ,Cxx$H]]_N   $$rctt|dz}d|vr|ddz|dz}n|jdd}|r tjj |}t |j tr|j jd}n |j }tj|}|d|k(r|d}|j||}n4tjjd j|||d n|j#|}|j%|j} | jd | } | S#tj $r|j#|}YZwxYw) aF Create or update (if file exists) and plot, spectacle, or dashboard object Parameters ---------- data: dict update/create API payload filetype: str One of 'plot', 'grid', 'spectacle_presentation', or 'dashboard' Returns ------- dict File info from API response srVrUr"Nrfiletyperz '{filename}' is already a {other_filetype} in your account. While you can overwrite {filetype}s with the same name, you can't overwrite files with a different type. Try deleting '{filename}' in your account or changing the filename.)r"rother_filetypefile)getattrr rCrlookuprArbytesdecoderloadsr*rr rrrr)raise_for_status) rPr api_moduler" lookup_resr matching_filerresrzs r rprpsuX^,J &,tJ/??88J- *2J*,,e4$,,33G<$,, JJw/MZ(H4#E* ''T2#..::!&!)!)'4Z'@!  "% I fi0I ,, *##D)C *sC E $E32E3c(tj}d|vr|ddz|dz}n|jdd}|r tjj |}t |j tr|j jd}n |j }tj|}|d}|j|}|j |j|}|j|j} | jd | } | S#tj$r } Yd} ~ ^d} ~ wwxYw#tj$rC} |dkDr8d| j vr*t#j$d t'||d z cYd} ~ Sd} ~ wwxYw) a% Create or overwrite (if file exists) a grid Parameters ---------- data: dict update/create API payload filetype: str One of 'plot', 'grid', 'spectacle_presentation', or 'dashboard' Returns ------- dict File info from API response rVrUr"NrrrrDr) max_retriesr)r rcrCrrrArrrrrdestroyrr rr)rErrrY) rPrrr"rrrrrrFrzs r rYrYsk J &,tJ/??88J- 2J*,,e4$,,33G<$,, JJw/M&C$$S)C  "% I fi0I +,,     ( ( ?/199< JJqM,T{QO O  s6BDD;D83D8;F7F F F  FcdeZdZdZeddZedZed dZedZedZ y) dashboard_opsa Interface to Plotly's Dashboards API. Plotly Dashboards are JSON blobs. They are made up by a bunch of containers which contain either empty boxes or boxes with file urls. For more info on Dashboard objects themselves, run `help(plotly.dashboard_objs)`. Example 1: Upload Simple Dashboard ``` import plotly.plotly as py import plotly.dashboard_objs as dashboard box_1 = { 'type': 'box', 'boxType': 'plot', 'fileId': 'username:123', 'title': 'box 1' } box_2 = { 'type': 'box', 'boxType': 'plot', 'fileId': 'username:456', 'title': 'box 2' } my_dboard = dashboard.Dashboard() my_dboard.insert(box_1) # my_dboard.get_preview() my_dboard.insert(box_2, 'above', 1) # my_dboard.get_preview() py.dashboard_ops.upload(my_dboard) ``` Example 2: Retreive Dashboard from Plotly ``` # works if you have at least one dashboard in your files import plotly.plotly as py import plotly.dashboard_objs as dashboard dboard_names = get_dashboard_names() first_dboard = get_dashboard(dboard_names[0]) first_dboard.get_preview() ``` c|dk(rd}n|dk(rd}n|dk(rd}tj||d}t|d}|d}|dk(r t|}|rt j |d|S) a BETA function for uploading/overwriting dashboards to Plotly. :param (dict) dashboard: the JSON dashboard to be uploaded. Use plotly.dashboard_objs.dashboard_objs to create a Dashboard object. :param (str) filename: the name of the dashboard to be saved in your Plotly account. Will overwrite a dashboard of the same name if it already exists in your files. :param (str) sharing: can be set to either 'public', 'private' or 'secret'. If 'public', your dashboard will be viewable by all other users. If 'private' only you can see your dashboard. If 'secret', the url will be returned with a sharekey appended to the url. Anyone with the url may view the dashboard. :param (bool) auto_open: automatically opens the dashboard in the browser. rXTrYFrZrr"r dashboardr^)rrrpr webbrowseropen_new) rrr"rrrrPrzrLs r rnzdashboard_ops.uploadPs& h !N  !"N  "Nzz), ,  &dK8  " h &s+C     ) 4 5 rc^g}tjjj}|dD]}|dr |j ||drXtj j d|dj}|dD]}|dr |j ||drX|S)NresultsdeletednextrC)r dashboardsrcrappendr request)rrrrs r _get_all_dashboardsz!dashboard_ops._get_all_dashboards|s mm  "'')Y -IY'!!), -&k((""5#f+6;;=C ^ 1  +%%i0 1&k rc|j}t|D]\}}|d|k(sntjj d|ddj }|rt j |d}|S|S)Nr"rCapi_urlsrr)rrr r rrr)rdashboard_name only_contentrrdboardrdashboard_jsons r _get_dashboard_jsonz!dashboard_ops._get_dashboard_jsons,,. &z2 ME6j!^3 HH$$ :e$Z0> $&  !ZZ )(<=N! ! rcN|j|}tj|S)z1Returns a Dashboard object from a dashboard name.)rr Dashboard)rrrs r get_dashboardzdashboard_ops.get_dashboards%00@"">22rcd|j}|Dcgc]}t|dc}Scc}w)z>Return list of all active dashboard names from users' account.r")rrF)rrrs r get_dashboard_namesz!dashboard_ops.get_dashboard_namess0,,. 6@AFF:&'AAAs-NrXTT) rrrrr<rnrrrrr rr rrso.`))V    33 BBrrc"eZdZdZeddZy)presentation_opsz< Interface to Plotly's Spectacle-Presentations API. c|dk(rd}n*|dvrd}n#tjjtt j |||d}t |d}|d}|dk(r t|}|rtj|d|S) as Function for uploading presentations to Plotly. :param (dict) presentation: the JSON presentation to be uploaded. Use plotly.presentation_objs.Presentation to create presentations from a Markdown-like string. :param (str) filename: the name of the presentation to be saved in your Plotly account. Will overwrite a presentation of the same name if it already exists in your files. :param (str) sharing: can be set to either 'public', 'private' or 'secret'. If 'public', your presentation will be viewable by all other users. If 'private' only you can see your presentation. If it is set to 'secret', the url will be returned with a string of random characters appended to the url which is called a sharekey. The point of a sharekey is that it makes the url very hard to guess, but anyone with the url can view the presentation. :param (bool) auto_open: automatically opens the presentation in the browser. See the documentation online for examples. rXT)rYrZFrspectacle_presentationr^rZ) rr rrkrrrprrr) r presentationr"rrrrPrzrLs r rnzpresentation_ops.uploads. h !N - -"N**667HI Izz,/ ,  &d,DE  " h &s+C     ) 4 5 rNrrr rr rrs,,rrc xddlm}t|jD]}dj |}||vr7||}t |s)||||z}|j |d||<||=O||vsT|j|} t| tstt|||||dj ||y)a" Extract inline data arrays from a graph_obj instance and place them in a grid Parameters ---------- obj_dict: dict dict representing a graph object that may contain inline arrays reference_obj: BasePlotlyType An empty instance of a `graph_obj` with type corresponding to obj_dict grid: Grid Grid to extract data arrays too path: str Path string of the location of `obj_dict` in the figure Returns ------- None Function modifies obj_dict and grid in-place r)Columnz{}srcTBDz {path}{prop}.)r5propN) chart_studio.grid_objsrrckeysrrr _validatorsrAr_extract_grid_graph_obj) obj_dict reference_objr]r5rrpropsrcrurpprop_validators r rrs,.X]]_%..& m #4.C}TD[1 F#$)!TN ] "*66trcddlm}|D]C}|j|j}|}|ddD]}||} |j||ddz<Ey)a Populate *src columns in a figure from uploaded grid Parameters ---------- figure: dict Figure dict that previously had inline data arrays extracted grid: Grid Grid that was created by extracting inline data arrays from figure using the _extract_grid_from_fig_like function Returns ------- None Function modifies figure in-place rrNrTsrc)r?r7_str_to_dict_pathrIrL)rSr]r7ru prop_path prop_parentrs r roroYsg"0400:  crN ,D%d+K ,.1VV IbME)* 4rc t||||S)a BETA function that creates plots with animations via `frames`. Creates an animated plot using 'frames' alongside 'data' and 'layout'. This BETA endpoint is subject to deprecation in the future. In relation to `plotly.plotly.plot`, folder-creation and overwriting are not supported but creating a plot with or without animations via frames is supported. :param (str) filename: if set to 'None', an automatically-generated plot name will be created. Does not support folder creation, meaning that a folder of the form 'folder/name' will NOT create a the folder and place the plot in it. :param (str) sharing: see `plotly.plotly.plot()` doc string. :param (bool) auto_open: if True, opens plot in the browser. If False, returns the url for the plot instead. Example 1: Simple Animation ``` import plotly.plotly as py from plotly.grid_objs import Grid, Column column_1 = Column([0.5], 'x') column_2 = Column([0.5], 'y') column_3 = Column([1.5], 'x2') column_4 = Column([1.5], 'y2') grid = Grid([column_1, column_2, column_3, column_4]) py.grid_ops.upload(grid, 'ping_pong_grid', auto_open=False) # create figure figure = { 'data': [ { 'xsrc': grid.get_column_reference('x'), 'ysrc': grid.get_column_reference('y'), 'mode': 'markers', } ], 'layout': {'title': 'Ping Pong Animation', 'xaxis': {'range': [0, 2], 'autorange': False}, 'yaxis': {'range': [0, 2], 'autorange': False}, 'updatemenus': [{ 'buttons': [ {'args': [None], 'label': u'Play', 'method': u'animate'} ], 'pad': {'r': 10, 't': 87}, 'showactive': False, 'type': 'buttons' }]}, 'frames': [ { 'data': [ { 'xsrc': grid.get_column_reference('x2'), 'ysrc': grid.get_column_reference('y2'), 'mode': 'markers', } ] }, { 'data': [ { 'xsrc': grid.get_column_reference('x'), 'ysrc': grid.get_column_reference('y'), 'mode': 'markers', } ] } ] } py.create_animations(figure, 'ping_pong') ``` Example 2: Growing Circles Animation ``` import plotly.plotly as py from plotly.grid_objs import Grid, Column column_1 = Column([0.9, 1.1], 'x') column_2 = Column([1.0, 1.0], 'y') column_3 = Column([0.8, 1.2], 'x2') column_4 = Column([1.2, 0.8], 'y2') column_5 = Column([0.7, 1.3], 'x3') column_6 = Column([0.7, 1.3], 'y3') column_7 = Column([0.6, 1.4], 'x4') column_8 = Column([1.5, 0.5], 'y4') column_9 = Column([0.4, 1.6], 'x5') column_10 = Column([1.2, 0.8], 'y5') grid = Grid([column_1, column_2, column_3, column_4, column_5, column_6, column_7, column_8, column_9, column_10]) py.grid_ops.upload(grid, 'growing_circles_grid', auto_open=False) # create figure figure = { 'data': [ { 'xsrc': grid.get_column_reference('x'), 'ysrc': grid.get_column_reference('y'), 'mode': 'markers', 'marker': {'color': '#48186a', 'size': 10} } ], 'layout': {'title': 'Growing Circles', 'xaxis': {'range': [0, 2], 'autorange': False}, 'yaxis': {'range': [0, 2], 'autorange': False}, 'updatemenus': [{ 'buttons': [ {'args': [None], 'label': u'Play', 'method': u'animate'} ], 'pad': {'r': 10, 't': 87}, 'showactive': False, 'type': 'buttons' }]}, 'frames': [ { 'data': [ { 'xsrc': grid.get_column_reference('x2'), 'ysrc': grid.get_column_reference('y2'), 'mode': 'markers', 'marker': {'color': '#3b528b', 'size': 25} } ] }, { 'data': [ { 'xsrc': grid.get_column_reference('x3'), 'ysrc': grid.get_column_reference('y3'), 'mode': 'markers', 'marker': {'color': '#26828e', 'size': 50} } ] }, { 'data': [ { 'xsrc': grid.get_column_reference('x4'), 'ysrc': grid.get_column_reference('y4'), 'mode': 'markers', 'marker': {'color': '#5ec962', 'size': 80} } ] }, { 'data': [ { 'xsrc': grid.get_column_reference('x5'), 'ysrc': grid.get_column_reference('y5'), 'mode': 'markers', 'marker': {'color': '#d8e219', 'size': 100} } ] } ] } py.create_animations(figure, 'growing_circles') ``` )r"rr)r@)rSr"rrs r create_animationsrusP 7i PPrcrddlm}m}t||||}t |t r/|j di}t ||r:|j}n)t ||r|jj}ni}t }|j dd|d<|j dd|d< t|dt|ddz|d< t|dt|ddz|d<tj|fi|S#ttf$rYJwxYw#ttf$rY)r?r7r8rrArBrCrDr9rErFrGrHr rI) rSr"rrr7r8rLr9rMs r icreate_animationsr s=@ FHgy AC&$Hb) fn -**,F FJ '--/FM#ZZ8M'$jj37M(D mG$%"%]7%;!r s '  D1AA0'C< (():):;%"=@>BGBGBT22j+z;|48hQV%-P r