pandas_GUI.plot_Pandas_GUI

  1def plot_pandas_GUI(df_info=None, show_text_col = False, **kwargs):
  2    """
  3    If passed no parameters this will look for all the dataframes in the user
  4    namespace and make them available for plotting. Once a
  5    dataframe is chosen only the numerical columns from that dataframe will
  6    be available for inclusion in the plotting expression.
  7
  8    This GUI produces code to use the plotly interactive plotting package.
  9
 10    If you wish to allow only certain dataframes or have them show up as
 11    user friendly names in the menus provide that information in the first
 12    paramater df_info.
 13
 14    To allow inclusion of text columns pass True for show_text_col.
 15
 16    :param bool show_text_col: (default = False). When True columns
 17    containing text will be shown.
 18
 19    :param list df_info: List of Lists [[object,globalname,userfriendly]],..]
 20      * object -- pandas.DataFrame
 21      * globalname -- string name of the object in the user global name space.
 22      * userfriendly -- string name to display for user selection.
 23
 24    :keyword string figname: string used to override default python name for
 25    figure.
 26
 27    :keyword bool findframes: default = True. If set to false and dataframes
 28    are passed in dfs_info, will not search for dataframes in the user
 29    namespace.
 30    """
 31    from ipywidgets import Layout, Box, HBox, VBox, GridBox, Tab, \
 32        Accordion, Dropdown, Label, Text, Button, Checkbox, FloatText, \
 33        RadioButtons, BoundedIntText, Output
 34    from ipywidgets import HTML as richLabel
 35    from IPython.display import display, HTML
 36    from IPython.display import Javascript as JS
 37    from IPython import get_ipython
 38    from JPSLUtils.utils import new_cell_immediately_below,\
 39        select_cell_immediately_below, move_cursor_in_current_cell, \
 40        insert_text_into_next_cell, insert_text_at_beginning_of_current_cell, \
 41        insert_newline_at_end_of_current_cell, select_containing_cell, \
 42        delete_selected_cell, iconselector, notice_group, notebookenv, \
 43        replace_text_of_next_cell
 44
 45    from .utils import find_pandas_dataframe_names, build_run_snip_widget
 46    from IPython import get_ipython
 47    global_dict = get_ipython().user_ns
 48    JPSLUtils = global_dict["JPSLUtils"]
 49    dfs_info = []
 50    if isinstance(df_info,list):
 51        for k in df_info:
 52            dfs_info.append(k)
 53    findframes = kwargs.pop('findframes',True)
 54    if findframes:
 55        for k in find_pandas_dataframe_names():
 56            dfs_info.append([global_dict[k],k,k])
 57    friendly_to_globalname = {k[2]:k[1] for k in dfs_info}
 58    friendly_to_object = {k[2]:k[0] for k in dfs_info}
 59
 60    figname = kwargs.pop('figname',None)
 61    from .utils import find_figure_names
 62    figlst = find_figure_names()
 63    if figname in figlst:
 64        raise UserWarning (str(figname) + ' already exists. Choose a '
 65                                          'different name for the figure.')
 66    if figname == None:
 67        figname = 'Figure_'+str(len(figlst)+1)
 68
 69    #### Define GUI Elements ####
 70    # Those followed by a * are required.
 71    output = Output()
 72    with output:
 73        display(HTML(
 74        "<h3 id ='pandasplotGUI' style='text-align:center;'>Pandas Plot "
 75        "Composer</h3> <div style='text-align:center;'>"
 76        "<span style='color:green;'>Steps with a * are required.</span> The "
 77        "code that will generate the plot is being "
 78        "built in the cell immediately below.</div><div "
 79        "style='text-align:center;'>This composer uses a subset of "
 80        "<a href ='https://plotly.com/python/line-and-scatter/#'> "
 81        "the plotly scatter plot</a> capabilities.</div>"))
 82
 83    longdesc = {'description_width':'initial'}
 84
 85    # Notices for the Final Check Tab.
 86    makeplot_notices = notice_group(['At least one trace required.',
 87                                     'Axes must have labels.'],
 88                                    'Notices:','','red')
 89    makeplot_notices.set_active([0,1])
 90
 91    # Strings for each tab, that are combined to make the code.
 92    importstr = '# CODE BLOCK generated using plot_pandas_GUI().\n# See ' \
 93        'https://jupyterphysscilab.github.io/jupyter_Pandas_GUI.\n' \
 94        'from plotly import graph_objects as go\n' + str(figname) + \
 95        ' = go.FigureWidget(layout_template=\"simple_white\")\n'
 96    step1strdefault = '\n# Trace declaration(s) and trace formatting\n'
 97    step1str = step1strdefault
 98    step2strdefault = '\n# Axes labels\n'
 99    step2str = step2strdefault
100    step3strdefault = '\n# Plot formatting\n'
101    step3str = step3strdefault
102    # 1. Pick Traces*
103    #   a. Select Y vs. X pairs* (DataFrame, X and Y, which must be from single
104    #       frame.
105    # Notices for the Pick Trace(s) tab.
106    notice_list = [
107        'Data set (DataFrame) required.',
108        'X- and Y-coordinates required.',
109        'Incomplete or inconsistent error specification(s).',
110        'Non-default trace formatting left from previous trace.',
111        'X-Error settings left from previous trace.',
112        'Y-Error settings left from previous trace.',
113    ]
114    trace_notices = notice_group(notice_list, 'Notices:','','red')
115    step1instr = richLabel(value = 'For each trace you wish to include: '
116                                   '<ol><li>Select a DataFrame (Data '
117                                   'set);</li>'
118                                   '<li>Select the column containing the X '
119                                   'values;</li>'
120                                   '<li>Select the column containing the Y '
121                                   'values;</li>'
122                                   '<li>Provide a name for the trace if you do'
123                                   ' not like the default. This text will be '
124                                   'used for the legend;</li>'
125                                   '<li> OPTIONAL - set additional formatting '
126                                   'and error display by expanding the '
127                                   'sections at the bottom of this tab;</li>'
128                                   '<li>Once everything is set use the '
129                                   '<b>"Add Trace"</b> button to '
130                                   'include it in your plot.</li></ol>')
131
132    step1instracc = Accordion(children = [step1instr])
133    step1instracc.set_title(0,'Instructions')
134    step1instracc.selected_index = None
135
136    # DataFrame selection
137    tempopts = []
138    tempopts.append('Choose data set.')
139    for k in dfs_info:
140        tempopts.append(k[2])
141    whichframe = Dropdown(options=tempopts,
142                                description='DataFrame: ',)
143
144    def update_columns(change):
145        df = friendly_to_object[change['new']]
146        tempcols = df.columns.values
147        if change['new'] == 'Choose data set.':
148            Xcoord.disabled = True
149            Ycoord.disabled = True
150            add_trace_but.disabled = True
151            add_trace_but.button_style = ''
152            trace_notices.activate_notice(0)
153            trace_notices.activate_notice(1)
154            add_trace_notices.value = trace_notices.notice_html()
155            return
156        tempopt = ['Choose column for coordinate.']
157        for k in tempcols:
158            if show_text_col:
159                tempopt.append(k)
160            else:
161                if df[k].dtype != 'O':
162                    tempopt.append(k)
163        Xcoord.options = tempopt
164        Xcoord.value = tempopt[0]
165        Ycoord.options = tempopt
166        Ycoord.value = tempopt[0]
167        Xcoord.disabled = False
168        Ycoord.disabled = False
169        trace_notices.activate_notice(1)
170        trace_notices.deactivate_notice(0)
171        add_trace_notices.value =trace_notices.notice_html()
172        pass
173    whichframe.observe(update_columns, names='value')
174
175    # Data selection
176    Xcoord = Dropdown(options=['Choose X-coordinate.'],
177                           description='X: ',
178                           disabled = True)
179    Ycoord = Dropdown(options=['Choose Y-coordinate.'],
180                           description='Y: ',
181                           disabled = True)
182    def trace_name_update(change):
183        if change['new'] != 'Choose column for coordinate.':
184            trace_name.value = Ycoord.value
185        if Xcoord.value != 'Choose column for coordinate.' and Ycoord.value \
186                != 'Choose column for coordinate.':
187            add_trace_but.disabled = False
188            add_trace_but.button_style = 'success'
189            modedrop.disabled = False
190            colordrop.disabled = False
191            yerrtype.disabled = False
192            xerrtype.disabled = False
193            trace_name.disabled = False
194            trace_notices.deactivate_notice(1)
195            add_trace_notices.value = trace_notices.notice_html()
196        else:
197            add_trace_but.disabled = True
198            add_trace_but.button_style = ''
199            modedrop.disabled = True
200            colordrop.disabled = True
201            yerrtype.disabled = True
202            xerrtype.disabled = True
203            trace_name.disabled = True
204            trace_notices.activate_notice(1)
205            add_trace_notices.value = trace_notices.notice_html()
206        pass
207
208    Ycoord.observe(trace_name_update,names='value')
209
210    # Trace name
211    trace_name = Text(placeholder = 'Trace name for legend',
212                      description = 'Trace name: ',
213                      disabled = True)
214
215    #   b. Trace Style (optional)
216    def trace_format_update(change):
217        trace_notices.deactivate_notice(3)
218        add_trace_notices.value = trace_notices.notice_html()
219        pass
220
221    modedrop = Dropdown(options = ['lines','markers','lines+markers'],
222                    description = 'Trace Style: ')
223    modedrop.observe(trace_format_update)
224    colordrop = Dropdown(options=['default','blue','orange','green','purple',
225                              'red','gold','brown','black'],
226                     description = 'Color: ')
227    colordrop.observe(trace_format_update)
228    iconlist = ['circle', 'square', 'caret-up', 'star', 'plus', 'times',
229                'caret-down', 'caret-left', 'caret-right']
230    icontoplotly = {'circle': 'circle', 'square': 'square',
231                   'caret-up': 'triangle-up', 'plus': 'cross',
232                   'times': 'x', 'caret-down': 'triangle-down',
233                   'caret-left': 'triangle-left', 'caret-right':
234                       'triangle-right', 'star': 'star'}
235    markerlabel = Label('Marker Choices: ')
236    marker_selector = iconselector(iconlist, selected = 'circle')
237    filled_open = Checkbox(value = True,
238                           description = 'Filled (uncheck for open)',
239                           style={'description_width':'initial'})
240    filled_open.observe(trace_format_update)
241    markersize = BoundedIntText(value = 6, min = 2, max = 25, step = 1,
242                                description = 'Marker Size (px): ',
243                                style=longdesc)
244    markersize.observe(trace_format_update)
245    markerhbox = HBox(children=[markerlabel,filled_open,markersize])
246    markervbox = VBox(children=[markerhbox, marker_selector.box])
247    line_style = Dropdown(options = ['solid','dot','dash','dashdot'],
248                          description = 'Line style: ')
249    line_style.observe(trace_format_update)
250    line_width = BoundedIntText(value = 2, min = 1, max = 25, step = 1,
251                                description = 'Linewidth (px): ',
252                                style=longdesc)
253    line_width.observe(trace_format_update)
254    linehbox = HBox(children=[line_style,line_width])
255
256    formatHbox1 = HBox(children=[modedrop,colordrop])
257    formatVbox = VBox(children=[formatHbox1,linehbox,markervbox])
258    step1formatacc = Accordion(children=[formatVbox])
259    step1formatacc.set_title(0,'Trace Formatting')
260    step1formatacc.selected_index = 0
261    yerrtype = Dropdown(options = ['none','percent','constant','data'],
262                        description = 'Error Type: ',
263                        disabled = True)
264
265    def error_settings_OK():
266        check = True
267        if (yerrtype.value == 'data') and (yerrdata.value == 'Choose error '
268                                                        'column.'):
269            check = False
270        if (xerrtype.value == 'data') and (xerrdata.value == 'Choose error '
271                                                        'column.'):
272            check = False
273        if (yerrtype.value == 'none' or yerrtype.value == 'percent' or
274            yerrtype.value == 'constant') and (xerrtype.value == 'none' or
275                                               xerrtype.value == 'percent'
276                                               or xerrtype.value =='constant'):
277            check = True
278        return check
279
280    def yerr_change(change):
281        df = friendly_to_object[whichframe.value]
282        if change['new'] == 'percent' or change['new'] == 'constant':
283            yerrvalue.disabled = False
284            yerrdata.disabled = True
285        if change['new'] == 'data':
286            yerrvalue.disabled = True
287            if yerrdata.value == 'Choose error column.':
288                add_trace_but.disabled = True
289                add_trace_but.button_style = ''
290            tempopts = ['Choose error column.']
291            tempcols = df.columns.values
292            for k in tempcols:
293                if df[k].dtype != 'O':
294                    tempopts.append(k)
295            yerrdata.options=tempopts
296            yerrdata.disabled = False
297        if change['new'] == 'none':
298            yerrvalue.disabled = True
299            yerrdata.disabled = True
300        if error_settings_OK():
301            add_trace_but.disabled = False
302            add_trace_but.button_style = 'success'
303            trace_notices.deactivate_notice(2)
304        else:
305            add_trace_but.disabled = True
306            add_trace_but.button_style = ''
307            trace_notices.activate_notice(2)
308        trace_notices.deactivate_notice(5)
309        add_trace_notices.value = trace_notices.notice_html()
310        pass
311
312    yerrtype.observe(yerr_change, names = 'value')
313
314    yerrvalue = FloatText(description = '% or constant: ', disabled = True,
315                          style=longdesc)
316    yerrdata = Dropdown(options = ['Choose error column.'],
317                        description = 'Error values: ',
318                        disabled = True)
319
320    def errdata_change(change):
321        if error_settings_OK():
322            add_trace_but.disabled = False
323            add_trace_but.button_style = 'success'
324            trace_notices.deactivate_notice(2)
325        else:
326            add_trace_but.disabled = True
327            add_trace_but.button_style = ''
328            trace_notices.activate_notice(2)
329        add_trace_notices.value = trace_notices.notice_html()
330        pass
331
332    yerrdata.observe(errdata_change, names = 'value')
333    yerrrow1 = HBox(children=[yerrtype,yerrvalue])
334    yerror = VBox(children=[yerrrow1,yerrdata])
335    xerrtype = Dropdown(options = ['none','percent','constant','data'],
336                        description = 'Error Type: ',
337                        disabled = True)
338    def xerr_change(change):
339        df = friendly_to_object[whichframe.value]
340        if change['new'] == 'percent' or change['new'] == 'constant':
341            xerrvalue.disabled = False
342            xerrdata.disabled = True
343        if change['new'] == 'data':
344            xerrvalue.disabled = True
345            if xerrdata.value == 'Choose error column.':
346                add_trace_but.disabled = True
347                add_trace_but.button_style = ''
348            tempopts = ['Choose error column.']
349            tempcols = df.columns.values
350            for k in tempcols:
351                if df[k].dtype != 'O':
352                    tempopts.append(k)
353            xerrdata.options = tempopts
354            xerrdata.disabled = False
355        if change['new'] == 'none':
356            xerrvalue.disabled = True
357            xerrdata.disabled = True
358        if error_settings_OK():
359            add_trace_but.disabled = False
360            add_trace_but.button_style = 'success'
361            trace_notices.deactivate_notice(2)
362        else:
363            add_trace_but.disabled = True
364            add_trace_but.button_style = ''
365            trace_notices.activate_notice(2)
366        trace_notices.deactivate_notice(4)
367        add_trace_notices.value = trace_notices.notice_html()
368        pass
369
370    xerrtype.observe(xerr_change, names = 'value')
371    xerrvalue = FloatText(description = '% or constant: ', disabled = True,
372                          style=longdesc)
373    xerrdata = Dropdown(options = ['Choose error column.'],
374                        description = 'Error values: ',
375                        disabled = True)
376
377    xerrdata.observe(errdata_change, names = 'value')
378    xerrrow1 = HBox(children=[xerrtype,xerrvalue])
379    xerror = VBox(children=[xerrrow1,xerrdata])
380    step1erracc = Accordion(children = [yerror,xerror])
381    step1erracc.set_title(0, 'Y error bars')
382    step1erracc.set_title(1, 'X error bars')
383    step1erracc.selected_index = None
384
385    # Add Trace button
386    add_trace_but = Button(description = 'Add Trace',
387                           disabled = True)
388    def do_add_trace(change):
389        nonlocal importstr, step1str, step2str, step3str
390        dfname = friendly_to_globalname[whichframe.value]
391        text = 'scat = go.Scatter(x = '+dfname+'[\'' \
392               +Xcoord.value+'\'],'
393        text += ' y = ' +dfname+'[\''+Ycoord.value+ \
394                                          '\'],\n'
395        text += '        mode = \''+modedrop.value+'\', name = \'' \
396                                               +trace_name.value+'\','
397        # in here add other formatting items using ifs.
398        if colordrop.value != 'default':
399            text +='\n        '
400            if str(modedrop.value).find('lines') > -1:
401                text += 'line_color = \''+colordrop.value+'\', '
402            if str(modedrop.value).find('markers') > -1:
403                text += 'marker_color = \'' + colordrop.value + '\', '
404        if str(modedrop.value).find('lines') > -1:
405            if line_style.value != 'solid':
406                text +='\n        '
407                text +='line_dash=\'' + line_style.value + '\', '
408            if line_width.value != 2:
409                text +='\n        '
410                text +='line_width=' + str(line_width.value) + ', '
411        if str(modedrop.value).find('markers') > -1:
412            if markersize.value != 6:
413                text += '\n        '
414                text += 'marker_size=' + str(markersize.value) + ', '
415            tmpmkr = icontoplotly[marker_selector.value]
416            if not filled_open.value:
417                text += '\n        '
418                tmpmkr +='-open'
419                text += 'marker_symbol=\'' + tmpmkr + '\', '
420            else:
421                if tmpmkr != 'circle':
422                    text += '\n        '
423                    text += 'marker_symbol=\'' + tmpmkr + '\', '
424        if yerrtype.value != 'none':
425            text +='\n        '
426            if yerrtype.value == 'data':
427                text += 'error_y_type=\'data\', ' \
428                        'error_y_array='+dfname
429                text += '[\''+yerrdata.value+'\'],'
430            else:
431                text += 'error_y_type=\''+yerrtype.value+'\', error_y_value='
432                text += str(yerrvalue.value)+','
433        if xerrtype.value != 'none':
434            text +='\n        '
435            if xerrtype.value == 'data':
436                text += 'error_x_type=\'data\', ' \
437                        'error_x_array='+dfname
438                text += '[\''+xerrdata.value+'\'],'
439            else:
440                text += 'error_x_type=\''+xerrtype.value+'\', error_x_value='
441                text += str(xerrvalue.value)+','
442        text += ')\n'
443        text += figname + '.add_trace(scat)\n'
444        step1str += text
445        if JPSLUtils.notebookenv == 'NBClassic':
446            replace_text_of_next_cell(importstr+step1str+step2str+step3str)
447        else:
448            codearea.sniptext.value = importstr+step1str+step2str+step3str
449        if (modedrop.value != 'lines') or (colordrop.value != 'default') or \
450            (line_style.value != 'solid') or (line_width.value != 2) or \
451            (icontoplotly[marker_selector.value] != 'circle') or \
452            (not filled_open.value) or (markersize.value != 6):
453            trace_notices.activate_notice(3)
454        if (xerrtype.value != 'none'):
455            trace_notices.activate_notice(4)
456        if (yerrtype.value != 'none'):
457            trace_notices.activate_notice(5)
458        add_trace_notices.value = trace_notices.notice_html()
459        makeplot_notices.deactivate_notice(0)
460        step4noticebox.value = makeplot_notices.notice_html()
461        pass
462    add_trace_but.on_click(do_add_trace)
463
464    trace_notices.set_active([0,1])
465    add_trace_notices = richLabel(value = trace_notices.notice_html())
466    step1tracebox = VBox(children=[whichframe,Xcoord,Ycoord,trace_name])
467    step1actionbox = VBox(children=[add_trace_but, add_trace_notices])
468    step1hbox = HBox(children=[step1tracebox,step1actionbox])
469    step1optbox = VBox(children=[step1formatacc, step1erracc])
470    step1opt = Accordion(children = [step1optbox])
471    step1opt.set_title(0, 'Optional (Trace formatting, error bars...)')
472    step1opt.selected_index = None
473    step1 = VBox(children=[step1instracc, step1hbox, step1opt])
474
475    # 2. Set Axes Labels (will use column names by default).
476    step2instr = richLabel(value = '<span style = "font-weight:bold;">You must '
477                                   'set the axes labels to something '
478                           'appropriate.</span> For example if the X - values '
479                           'represent time in seconds "Time (s)" is a good '
480                           'choice. If the Y - values for the traces all '
481                           'have the same units using the units as the label '
482                                   'is a good choice. If the Y - values '
483                                   'have different unit quantites the best '
484                                   'option is probably "values" and making '
485                                   'sure that the trace names used for the '
486                                   'legend contain the units for each trace.')
487    step2instracc = Accordion(children = [step2instr])
488    step2instracc.set_title(0,'Instructions')
489    step2instracc.selected_index = None
490    X_label = Text(placeholder = 'Provide an X-axis label (usually has units)',
491                   description = 'X-axis label: ',
492                   style = longdesc,
493                   layout=Layout(width='45%'))
494    Y_label = Text(placeholder = 'Provide a Y-axis label (usually has units)',
495                   description = 'Y-axis label: ',
496                   style = longdesc,
497                   layout=Layout(width='45%'))
498    step2hbox = HBox(children=[X_label,Y_label])
499    step2 = VBox(children=[step2instracc,step2hbox])
500    # 3.Title, Format ...
501    step3instr = richLabel(value='Overall format set here. <ul><li>Experiment '
502                                 'with '
503                                 'the Plot Styling templates to find your '
504                                 'favorite.</li>'
505                                 '<li>If the Aspect Ratio is set to `auto` the '
506                           'figure will fill the default output region. '
507                           'Other choices will allow you to pick the Plot '
508                           'Size. `Large` will use about 2/3 of an HD '
509                                 '(1920X1080) screen.</li>')
510    step3instracc = Accordion(children=[step3instr])
511    step3instracc.set_title(0, 'Instructions')
512    step3instracc.selected_index = None
513    plot_title = Text(value = figname,
514                       description = 'Plot title: ',
515                      layout = Layout(width='80%'))
516    def mirror_axes_change(change):
517        if change['new']:
518            mirror_ticks.disabled= False
519        else:
520            mirror_ticks.disabled= True
521            mirror_ticks.value = False
522        pass
523
524    mirror_axes = Checkbox(value = False,
525                           description = 'Display Mirror Axes',
526                           style = longdesc)
527    mirror_axes.observe(mirror_axes_change, names = 'value')
528    mirror_ticks = Checkbox(value = False,
529                            description = 'Mirror Tick Marks',
530                            disabled = True)
531    plot_template = Dropdown(options=['none','simple_white', 'ggplot2',
532                                    'seaborn',
533                                 'plotly', 'plotly_white', 'plotly_dark',
534                                 'presentation', 'xgridoff', 'ygridoff',
535                                 'gridon', 'simple_white+presentation',
536                                      'simple_white+gridon',
537                                      'simple_white+presentation+gridon'],
538                        value='simple_white',
539                        description = 'Plot Styling: ',
540                        style = longdesc)
541    def aspect_change(change):
542        if change['new'] != 'auto':
543            plot_size.disabled=False
544        else:
545            plot_size.disabled=True
546        pass
547
548    plot_aspect = Dropdown(options = ['auto', '16:9', '5:3', '7:5', '4:3',
549                                     '10:8', '1:1'],
550                      value = 'auto',
551                      description = 'Aspect Ratio: ',
552                      style = longdesc)
553    plot_aspect.observe(aspect_change, names = 'value')
554    plot_size = Dropdown(options = ['tiny', 'small', 'medium', 'large',
555                                    'huge'],
556                         value = 'large',
557                         description = 'Plot Size: ',
558                         style = longdesc,
559                         disabled = True)
560    step3hbox2 = HBox(children=[mirror_axes,mirror_ticks, plot_template,
561                                plot_aspect, plot_size])
562    step3 = VBox(children=[step3instracc, plot_title, step3hbox2])
563
564    # 4. Final Check*
565    step4instr = richLabel(value = 'Things to check before clicking making ' \
566                                   'the plot: <ul>' \
567                                   '<li>Fix any problems listed in ' \
568                                   '"Notices".</li>' \
569                                   '<li>Look at the code below to make sure ' \
570                                   'you have included all the traces you ' \
571                                   'intended to (look for "name").</li>' \
572                                   '<li>Check for any unpaired parentheses, ' \
573                                   'brackets or braces.</li>' \
574                                   '<li>Check that all single and double ' \
575                                   'quotes are paired.</li>' \
576                                   '<li>If you did any manual editing ' \
577                                   'double-check for typos.</li>')
578    step4noticebox = richLabel(value = makeplot_notices.notice_html())
579    def makeplt_click(change):
580        if JPSLUtils.notebookenv == 'NBClassic':
581            # These commented out lines do nothing because of timing issues.
582            # text = '\n# Force save widget states so that graph will still be\n'
583            # text += '# available when notebook next opened in trusted state.\n'
584            # text += 'import time\ntime.sleep(5)'
585            select_containing_cell('pandasplotGUI')
586            select_cell_immediately_below()
587            # insert_newline_at_end_of_current_cell(text)
588            # jscode = 'Jupyter.actions.call("widgets:save-with-widgets");'
589            # text = 'JPSLUtils.OTJS(\''+jscode+'\')'
590            # insert_newline_at_end_of_current_cell(text)
591        # run the cell to build the plot
592            JPSLUtils.OTJS('Jupyter.notebook.get_selected_cell().execute();')
593        # remove the GUI cell
594            select_containing_cell('pandasplotGUI')
595            delete_selected_cell()
596        pass
597
598    makeplotbut_lay = Layout(visibility="hidden")
599    if JPSLUtils.notebookenv == 'NBClassic':
600        makeplotbut_lay = Layout(visibility="visible")
601
602    makeplotbut = Button(description = 'Make Plot',
603                         layout = makeplotbut_lay,
604                         disabled = True)
605    makeplotbut.on_click(makeplt_click)
606    step4vbox = VBox(children=[makeplotbut,step4noticebox])
607    step4 = HBox(children=[step4instr,step4vbox])
608
609
610    steps = Tab(children=[step1, step2, step3, step4])
611    steps.set_title(0,'1. Pick Trace(s)*')
612    steps.set_title(1,'2. Label Axes*')
613    steps.set_title(2,'3. Title, Format ...')
614    steps.set_title(3,'4. Final Check*')
615    def tab_changed(change):
616        nonlocal importstr, step1strdefault, step1str, step2strdefault, \
617            step2str, step3strdefault, step3str
618        if change['new'] ==3:
619            if X_label.value == '' or Y_label.value == '':
620                makeplot_notices.activate_notice(1)
621                makeplotbut.disabled = True
622                makeplotbut.button_style = ''
623            else:
624                makeplot_notices.deactivate_notice(1)
625            step4noticebox.value = makeplot_notices.notice_html()
626        if len(makeplot_notices.get_active()) == 0:
627            makeplotbut.disabled = False
628            makeplotbut.button_style = 'success'
629        if change['new'] > 1:
630            # update step2str
631            step2str = step2strdefault
632            text = figname + '.update_xaxes(title= \'' + X_label.value + '\''
633
634            def get_mirror_text():
635                if mirror_axes.value:
636                    mirror_text = ', mirror = True)\n'
637                    if mirror_ticks.value:
638                        mirror_text = ', mirror= \'ticks\')\n'
639                else:
640                    mirror_text = ')\n'
641                return mirror_text
642
643            text += get_mirror_text()
644            step2str += text
645            text = figname + '.update_yaxes(title= \'' + Y_label.value + '\''
646            text += get_mirror_text()
647            step2str += text
648            # update step3str
649            step3str = step3strdefault
650            plot_width = 1200
651            plot_height = 675
652            if plot_title.value != '' or plot_template.value != 'simple_white':
653                text = figname + '.update_layout(title = \'' + plot_title.value + '\', '
654                text += 'template = \'' + plot_template.value + '\', '
655            if plot_aspect.value == 'auto':
656                text += 'autosize=True)\n'
657            else:
658                if plot_size.value == 'tiny':
659                    plot_width = 300
660                elif plot_size.value == 'small':
661                    plot_width = 450
662                elif plot_size.value == 'medium':
663                    plot_width = 800
664                elif plot_size.value == 'large':
665                    plot_width = 1200
666                elif plot_size.value == 'huge':
667                    plot_width = 2400
668                if plot_aspect.value == '16:9':
669                    plot_height = int(9 * plot_width / 16)
670                elif plot_aspect.value == '5:3':
671                    plot_height = int(3 * plot_width / 5)
672                elif plot_aspect.value == '7:5':
673                    plot_height = int(5 * plot_width / 7)
674                elif plot_aspect.value == '4:3':
675                    plot_height = int(3 * plot_width / 4)
676                elif plot_aspect.value == '10:8':
677                    plot_height = int(8 * plot_width / 10)
678                elif plot_aspect.value == '1:1':
679                    plot_height = plot_width
680                text += 'autosize=False,\n                        width = int('
681                text += str(plot_width)+'), height=int('
682                text += str(plot_height)+'))\n'
683            step3str += text
684            text = figname + '.show(config = {' \
685                    '\'toImageButtonOptions\': {\'format\': \'svg\'}})'
686            if JPSLUtils.notebookenv == 'NBClassic':
687                replace_text_of_next_cell(
688                    importstr+step1str+step2str+step3str+text)
689            else:
690                codearea.sniptext.value = importstr+step1str+step2str+step3str+text
691
692        pass
693
694    steps.observe(tab_changed, names = 'selected_index')
695    with output:
696        display(steps)
697    if JPSLUtils.notebookenv == 'NBClassic':
698        display(output)
699        select_containing_cell('pandasplotGUI')
700        new_cell_immediately_below()
701        insert_text_into_next_cell(importstr+step1str+step2str+step3str)
702    else:
703        codearea = build_run_snip_widget(
704            importstr+step1str+step2str+step3str, output)
705        with output:
706            display(codearea)
707        display(output)
708    pass