Repository: plotly/plotly.py

Issue:
Stream TypeError: 'str' does not support the buffer interface
Hello.

When I try [this](http://nbviewer.ipython.org/github/plotly/python-user-guide/blob/master/s7_streaming/s7_streaming_p1-first-stream.ipynb) code I get an error in rendering Cell number 11:

```
TypeError: 'str' does not support the buffer interface
```

I guess it's because I'm running `Python 3.4`. Since Python 3 there is necessary to treat bytes and unicodes differently.



Discussion:
I confirm this bug on Python 3.4. 

Thanks for reaching out to us.


Resolving patch:
diff --git a/plotly/plotly/chunked_requests/chunked_request.py b/plotly/plotly/chunked_requests/chunked_request.py
--- a/plotly/plotly/chunked_requests/chunked_request.py
+++ b/plotly/plotly/chunked_requests/chunked_request.py
@@ -61,7 +61,7 @@ def write(self, data, reconnect_on=('', 200, )):
             msglen = format(len(msg), 'x')  # msg length in hex
             # Send the message in chunk-encoded form
             self._conn.send('{msglen}\r\n{msg}\r\n'
-                            .format(msglen=msglen, msg=msg))
+                            .format(msglen=msglen, msg=msg).encode('utf-8'))
         except http_client.socket.error:
             self._reconnect()
             self.write(data)
@@ -84,7 +84,7 @@ def _connect(self):
         # Set blocking to False prevents recv
         # from blocking while waiting for a response.
         self._conn.sock.setblocking(False)
-        self._bytes = ''
+        self._bytes = six.b('')
         self._reset_retries()
         time.sleep(0.5)
 
@@ -103,7 +103,7 @@ def close(self):
         # For some reason, either Python or node.js seems to
         # require an extra \r\n.
         try:
-            self._conn.send('\r\n0\r\n\r\n')
+            self._conn.send('\r\n0\r\n\r\n'.encode('utf-8'))
         except http_client.socket.error:
             # In case the socket has already been closed
             return ''
@@ -123,21 +123,21 @@ def _getresponse(self):
         response = self._bytes
         while True:
             try:
-                bytes = self._conn.sock.recv(1)
+                _bytes = self._conn.sock.recv(1)
             except http_client.socket.error:
                 # For error 54: Connection reset by peer
                 # (and perhaps others)
-                return ''
-            if bytes == '':
+                return six.b('')
+            if _bytes == six.b(''):
                 break
             else:
-                response += bytes
+                response += _bytes
         # Set recv to be non-blocking again
         self._conn.sock.setblocking(False)
 
         # Convert the response string to a http_client.HTTPResponse
         # object with a bit of a hack
-        if response != '':
+        if response != six.b(''):
             # Taken from
             # http://pythonwise.blogspot.ca/2010/02/parse-http-response.html
             try:
@@ -145,7 +145,7 @@ def _getresponse(self):
                 response.begin()
             except:
                 # Bad headers ... etc.
-                response = ''
+                response = six.b('')
         return response
 
     def _isconnected(self):
@@ -173,7 +173,7 @@ def _isconnected(self):
             # 3 - Check if the server has returned any data.
             # If they have, then start to store the response
             # in _bytes.
-            self._bytes = ''
+            self._bytes = six.b('')
             self._bytes = self._conn.sock.recv(1)
             return False
         except http_client.socket.error as e:
diff --git a/plotly/plotly/plotly.py b/plotly/plotly/plotly.py
--- a/plotly/plotly/plotly.py
+++ b/plotly/plotly/plotly.py
@@ -164,7 +164,8 @@ def plot(figure_or_data, validate=True, **plot_options):
                                          "to Plotly anyway (not recommended), "
                                          "you can set 'validate=False' as a "
                                          "plot option.\nHere's why you're "
-                                         "seeing this error:\n\n{}".format(err))
+                                         "seeing this error:\n\n{0}"
+                                         "".format(err))
     for entry in figure['data']:
         for key, val in list(entry.items()):
             try:
@@ -309,7 +310,8 @@ def get_figure(file_owner_or_url, file_id=None, raw=False):
             raise exceptions.PlotlyError(
                 "Because you didn't supply a 'file_id' in the call, "
                 "we're assuming you're trying to snag a figure from a url. "
-                "You supplied the url, '{}', we expected it to start with '{}'."
+                "You supplied the url, '{0}', we expected it to start with "
+                "'{1}'."
                 "\nRun help on this function for more information."
                 "".format(url, plotly_rest_url))
         head = plotly_rest_url + "/~"
@@ -460,22 +462,22 @@ def write(self, trace, layout=None, validate=True,
                 tools.validate(stream_object, stream_object['type'])
             except exceptions.PlotlyError as err:
                 raise exceptions.PlotlyError(
-                    "Part of the data object with type, '{}', is invalid. This "
-                    "will default to 'scatter' if you do not supply a 'type'. "
-                    "If you do not want to validate your data objects when "
-                    "streaming, you can set 'validate=False' in the call to "
-                    "'your_stream.write()'. Here's why the object is "
-                    "invalid:\n\n{}".format(stream_object['type'], err)
+                    "Part of the data object with type, '{0}', is invalid. "
+                    "This will default to 'scatter' if you do not supply a "
+                    "'type'. If you do not want to validate your data objects "
+                    "when streaming, you can set 'validate=False' in the call "
+                    "to 'your_stream.write()'. Here's why the object is "
+                    "invalid:\n\n{1}".format(stream_object['type'], err)
                 )
             try:
                 tools.validate_stream(stream_object, stream_object['type'])
             except exceptions.PlotlyError as err:
                 raise exceptions.PlotlyError(
-                    "Part of the data object with type, '{}', cannot yet be "
+                    "Part of the data object with type, '{0}', cannot yet be "
                     "streamed into Plotly. If you do not want to validate your "
                     "data objects when streaming, you can set 'validate=False' "
                     "in the call to 'your_stream.write()'. Here's why the "
-                    "object cannot be streamed:\n\n{}"
+                    "object cannot be streamed:\n\n{1}"
                     "".format(stream_object['type'], err)
                 )
             if layout is not None:
@@ -484,7 +486,7 @@ def write(self, trace, layout=None, validate=True,
                 except exceptions.PlotlyError as err:
                     raise exceptions.PlotlyError(
                         "Your layout kwarg was invalid. "
-                        "Here's why:\n\n{}".format(err)
+                        "Here's why:\n\n{0}".format(err)
                     )
         del stream_object['type']
 
diff --git a/plotly/tools.py b/plotly/tools.py
--- a/plotly/tools.py
+++ b/plotly/tools.py
@@ -12,6 +12,7 @@
 import os
 import os.path
 import warnings
+import six
 
 from plotly import utils
 from plotly import exceptions
@@ -97,9 +98,9 @@ def set_credentials_file(username=None, api_key=None, stream_ids=None):
                                      "to run this function.")
     ensure_local_plotly_files()  # make sure what's there is OK
     credentials = get_credentials_file()
-    if isinstance(username, str):
+    if isinstance(username, six.string_types):
         credentials['username'] = username
-    if isinstance(api_key, str):
+    if isinstance(api_key, six.string_types):
         credentials['api_key'] = api_key
     if isinstance(stream_ids, (list, tuple)):
         credentials['stream_ids'] = stream_ids
@@ -130,22 +131,6 @@ def reset_credentials_file():
     ensure_local_plotly_files()  # put the defaults back
 
 
-# def show_credentials_file(*args):  # TODO, can we lose this?
-#     """Print specified kwargs from `~/.plotly_credentials`.
-#
-#     Prints all if no keyword arguments are specified.
-#
-#     """
-#     ensure_local_plotly_files() # make sure what's there is OK
-#     credentials = get_credentials_file(*args)
-#     if len(args):
-#         print "The specified keys from your credentials file:\n"
-#     else:
-#         print "Your credentials file:\n"
-#     for key, val in credentials.items():
-#         print "\t{}: {}".format(key, val).expandtabs()
-
-
 ### config tools ###
 
 def set_config_file(plotly_domain=None, plotly_streaming_domain=None):
@@ -157,9 +142,9 @@ def set_config_file(plotly_domain=None, plotly_streaming_domain=None):
                                      "to run this function.")
     ensure_local_plotly_files()  # make sure what's there is OK
     settings = get_config_file()
-    if isinstance(plotly_domain, str):
+    if isinstance(plotly_domain, six.string_types):
         settings['plotly_domain'] = plotly_domain
-    if isinstance(plotly_streaming_domain, str):
+    if isinstance(plotly_streaming_domain, six.string_types):
         settings['plotly_streaming_domain'] = plotly_streaming_domain
     utils.save_json_dict(CONFIG_FILE, settings)
     ensure_local_plotly_files()  # make sure what we just put there is OK
@@ -220,7 +205,8 @@ def get_embed(file_owner_or_url, file_id=None, width="100%", height=525):
             raise exceptions.PlotlyError(
                 "Because you didn't supply a 'file_id' in the call, "
                 "we're assuming you're trying to snag a figure from a url. "
-                "You supplied the url, '{}', we expected it to start with '{}'."
+                "You supplied the url, '{0}', we expected it to start with "
+                "'{1}'."
                 "\nRun help on this function for more information."
                 "".format(url, plotly_rest_url))
         head = plotly_rest_url + "/~"
@@ -414,13 +400,13 @@ def get_subplots(rows=1, columns=1, horizontal_spacing=0.1,
     plot_num = 0
     for rrr in range(rows):
         for ccc in range(columns):
-            xaxis_name = 'xaxis{}'.format(plot_num + 1)
-            x_anchor = 'y{}'.format(plot_num + 1)
+            xaxis_name = 'xaxis{0}'.format(plot_num + 1)
+            x_anchor = 'y{0}'.format(plot_num + 1)
             x_start = (plot_width + horizontal_spacing) * ccc
             x_end = x_start + plot_width
 
-            yaxis_name = 'yaxis{}'.format(plot_num + 1)
-            y_anchor = 'x{}'.format(plot_num + 1)
+            yaxis_name = 'yaxis{0}'.format(plot_num + 1)
+            y_anchor = 'x{0}'.format(plot_num + 1)
             y_start = (plot_height + vertical_spacing) * rrr
             y_end = y_start + plot_height
 
@@ -436,7 +422,7 @@ def get_subplots(rows=1, columns=1, horizontal_spacing=0.1,
         for rrr in range(rows):
             grid_line = ""
             for ccc in range(columns):
-                grid_line += "[{}]\t".format(plot)
+                grid_line += "[{0}]\t".format(plot)
                 plot += 1
             grid_string = grid_line + '\n' + grid_string
         print(grid_string)
@@ -456,7 +442,7 @@ def get_valid_graph_obj(obj, obj_type=None):
             new_obj = graph_objs.NAME_TO_CLASS[obj_type]()
         except KeyError:
             raise exceptions.PlotlyError(
-                "'{}' nor '{}' are recognizable graph_objs.".
+                "'{0}' nor '{1}' are recognizable graph_objs.".
                 format(obj.__class__.__name__, obj_type))
     if isinstance(new_obj, list):
         new_obj += obj
@@ -483,7 +469,7 @@ def validate(obj, obj_type):
         test_obj = graph_objs.NAME_TO_CLASS[obj_type](obj)
     except KeyError:
         raise exceptions.PlotlyError(
-            "'{}' is not a recognizable graph_obj.".
+            "'{0}' is not a recognizable graph_obj.".
             format(obj_type))
 
 
@@ -504,13 +490,14 @@ def validate_stream(obj, obj_type):
         if 'streamable' in info[key]:
             if not info[key]['streamable']:
                 raise exceptions.PlotlyError(
-                    "The '{}' key is not streamable in the '{}' object".format(
+                    "The '{0}' key is not streamable in the '{1}' "
+                    "object".format(
                         key, obj_type
                     )
                 )
         else:
             raise exceptions.PlotlyError(
-                "The '{}' key is not streamable in the '{}' object".format(
+                "The '{0}' key is not streamable in the '{1}' object".format(
                     key, obj_type
                 )
             )
@@ -533,7 +520,7 @@ def _replace_newline(obj):
         for index, entry in enumerate(obj):
             l += [_replace_newline(entry)]
         return l
-    elif isinstance(obj, str):
+    elif isinstance(obj, six.string_types):
         s = obj.replace('\n', '<br>')
         if s != obj:
             warnings.warn("Looks like you used a newline character: '\\n'.\n\n"


Test patch:
diff --git a/plotly/tests/coverage/index.html b/plotly/tests/coverage/index.html
--- a/plotly/tests/coverage/index.html
+++ b/plotly/tests/coverage/index.html
@@ -18,7 +18,7 @@
 <div id='header'>
     <div class='content'>
         <h1>Coverage report:
-            <span class='pc_cov'>60%</span>
+            <span class='pc_cov'>77%</span>
         </h1>
         <img id='keyboard_icon' src='keybd_closed.png'>
     </div>
@@ -56,11 +56,11 @@ <h1>Coverage report:
         <tfoot>
             <tr class='total'>
                 <td class='name left'>Total</td>
-                <td>1733</td>
-                <td>686</td>
+                <td>1710</td>
+                <td>395</td>
                 <td>0</td>
                 
-                <td class='right'>60%</td>
+                <td class='right'>77%</td>
             </tr>
         </tfoot>
         <tbody>
@@ -76,11 +76,11 @@ <h1>Coverage report:
             
             <tr class='file'>
                 <td class='name left'><a href='plotly_graph_objs_graph_objs.html'>plotly/graph_objs/graph_objs</a></td>
-                <td>608</td>
-                <td>220</td>
+                <td>581</td>
+                <td>63</td>
                 <td>0</td>
                 
-                <td class='right'>64%</td>
+                <td class='right'>89%</td>
             </tr>
             
             <tr class='file'>
@@ -103,7 +103,7 @@ <h1>Coverage report:
             
             <tr class='file'>
                 <td class='name left'><a href='plotly_matplotlylib_renderer.html'>plotly/matplotlylib/renderer</a></td>
-                <td>216</td>
+                <td>217</td>
                 <td>59</td>
                 <td>0</td>
                 
@@ -112,29 +112,29 @@ <h1>Coverage report:
             
             <tr class='file'>
                 <td class='name left'><a href='plotly_plotly_plotly.html'>plotly/plotly/plotly</a></td>
-                <td>269</td>
-                <td>155</td>
+                <td>270</td>
+                <td>104</td>
                 <td>0</td>
                 
-                <td class='right'>42%</td>
+                <td class='right'>61%</td>
             </tr>
             
             <tr class='file'>
                 <td class='name left'><a href='plotly_tools.html'>plotly/tools</a></td>
-                <td>231</td>
-                <td>132</td>
+                <td>233</td>
+                <td>51</td>
                 <td>0</td>
                 
-                <td class='right'>43%</td>
+                <td class='right'>78%</td>
             </tr>
             
             <tr class='file'>
                 <td class='name left'><a href='plotly_utils.html'>plotly/utils</a></td>
                 <td>108</td>
-                <td>65</td>
+                <td>63</td>
                 <td>0</td>
                 
-                <td class='right'>40%</td>
+                <td class='right'>42%</td>
             </tr>
             
             <tr class='file'>
diff --git a/plotly/tests/coverage/plotly_graph_objs_graph_objs.html b/plotly/tests/coverage/plotly_graph_objs_graph_objs.html
--- a/plotly/tests/coverage/plotly_graph_objs_graph_objs.html
+++ b/plotly/tests/coverage/plotly_graph_objs_graph_objs.html
@@ -5,7 +5,7 @@
     
     
     <meta http-equiv='X-UA-Compatible' content='IE=emulateIE7' />
-    <title>Coverage for plotly/graph_objs/graph_objs: 64%</title>
+    <title>Coverage for plotly/graph_objs/graph_objs: 89%</title>
     <link rel='stylesheet' href='style.css' type='text/css'>
     
     <script type='text/javascript' src='jquery.min.js'></script>
@@ -21,13 +21,13 @@
 <div id='header'>
     <div class='content'>
         <h1>Coverage for <b>plotly/graph_objs/graph_objs</b> :
-            <span class='pc_cov'>64%</span>
+            <span class='pc_cov'>89%</span>
         </h1>
         <img id='keyboard_icon' src='keybd_closed.png'>
         <h2 class='stats'>
-            608 statements &nbsp;
-            <span class='run hide_run shortkey_r button_toggle_run'>388 run</span>
-            <span class='mis shortkey_m button_toggle_mis'>220 missing</span>
+            581 statements &nbsp;
+            <span class='run hide_run shortkey_r button_toggle_run'>518 run</span>
+            <span class='mis shortkey_m button_toggle_mis'>63 missing</span>
             <span class='exc shortkey_x button_toggle_exc'>0 excluded</span>
             
         </h2>
@@ -86,24 +86,24 @@ <h2 class='stats'>
 <p id='n23' class='pln'><a href='#n23'>23</a></p>
 <p id='n24' class='pln'><a href='#n24'>24</a></p>
 <p id='n25' class='stm run hide_run'><a href='#n25'>25</a></p>
-<p id='n26' class='stm run hide_run'><a href='#n26'>26</a></p>
+<p id='n26' class='pln'><a href='#n26'>26</a></p>
 <p id='n27' class='stm run hide_run'><a href='#n27'>27</a></p>
 <p id='n28' class='stm run hide_run'><a href='#n28'>28</a></p>
 <p id='n29' class='stm run hide_run'><a href='#n29'>29</a></p>
 <p id='n30' class='stm run hide_run'><a href='#n30'>30</a></p>
 <p id='n31' class='stm run hide_run'><a href='#n31'>31</a></p>
-<p id='n32' class='pln'><a href='#n32'>32</a></p>
+<p id='n32' class='stm run hide_run'><a href='#n32'>32</a></p>
 <p id='n33' class='stm run hide_run'><a href='#n33'>33</a></p>
-<p id='n34' class='stm mis'><a href='#n34'>34</a></p>
-<p id='n35' class='stm mis'><a href='#n35'>35</a></p>
-<p id='n36' class='pln'><a href='#n36'>36</a></p>
-<p id='n37' class='stm run hide_run'><a href='#n37'>37</a></p>
-<p id='n38' class='stm run hide_run'><a href='#n38'>38</a></p>
+<p id='n34' class='stm run hide_run'><a href='#n34'>34</a></p>
+<p id='n35' class='pln'><a href='#n35'>35</a></p>
+<p id='n36' class='stm run hide_run'><a href='#n36'>36</a></p>
+<p id='n37' class='stm mis'><a href='#n37'>37</a></p>
+<p id='n38' class='stm mis'><a href='#n38'>38</a></p>
 <p id='n39' class='pln'><a href='#n39'>39</a></p>
 <p id='n40' class='stm run hide_run'><a href='#n40'>40</a></p>
-<p id='n41' class='pln'><a href='#n41'>41</a></p>
+<p id='n41' class='stm run hide_run'><a href='#n41'>41</a></p>
 <p id='n42' class='pln'><a href='#n42'>42</a></p>
-<p id='n43' class='pln'><a href='#n43'>43</a></p>
+<p id='n43' class='stm run hide_run'><a href='#n43'>43</a></p>
 <p id='n44' class='pln'><a href='#n44'>44</a></p>
 <p id='n45' class='pln'><a href='#n45'>45</a></p>
 <p id='n46' class='pln'><a href='#n46'>46</a></p>
@@ -135,19 +135,19 @@ <h2 class='stats'>
 <p id='n72' class='pln'><a href='#n72'>72</a></p>
 <p id='n73' class='pln'><a href='#n73'>73</a></p>
 <p id='n74' class='pln'><a href='#n74'>74</a></p>
-<p id='n75' class='stm run hide_run'><a href='#n75'>75</a></p>
-<p id='n76' class='stm run hide_run'><a href='#n76'>76</a></p>
+<p id='n75' class='pln'><a href='#n75'>75</a></p>
+<p id='n76' class='pln'><a href='#n76'>76</a></p>
 <p id='n77' class='pln'><a href='#n77'>77</a></p>
 <p id='n78' class='stm run hide_run'><a href='#n78'>78</a></p>
-<p id='n79' class='pln'><a href='#n79'>79</a></p>
-<p id='n80' class='stm run hide_run'><a href='#n80'>80</a></p>
-<p id='n81' class='pln'><a href='#n81'>81</a></p>
+<p id='n79' class='stm run hide_run'><a href='#n79'>79</a></p>
+<p id='n80' class='pln'><a href='#n80'>80</a></p>
+<p id='n81' class='stm run hide_run'><a href='#n81'>81</a></p>
 <p id='n82' class='pln'><a href='#n82'>82</a></p>
-<p id='n83' class='pln'><a href='#n83'>83</a></p>
-<p id='n84' class='stm run hide_run'><a href='#n84'>84</a></p>
+<p id='n83' class='stm run hide_run'><a href='#n83'>83</a></p>
+<p id='n84' class='pln'><a href='#n84'>84</a></p>
 <p id='n85' class='pln'><a href='#n85'>85</a></p>
 <p id='n86' class='pln'><a href='#n86'>86</a></p>
-<p id='n87' class='pln'><a href='#n87'>87</a></p>
+<p id='n87' class='stm run hide_run'><a href='#n87'>87</a></p>
 <p id='n88' class='pln'><a href='#n88'>88</a></p>
 <p id='n89' class='pln'><a href='#n89'>89</a></p>
 <p id='n90' class='pln'><a href='#n90'>90</a></p>
@@ -186,10 +186,10 @@ <h2 class='stats'>
 <p id='n123' class='pln'><a href='#n123'>123</a></p>
 <p id='n124' class='pln'><a href='#n124'>124</a></p>
 <p id='n125' class='pln'><a href='#n125'>125</a></p>
-<p id='n126' class='stm run hide_run'><a href='#n126'>126</a></p>
+<p id='n126' class='pln'><a href='#n126'>126</a></p>
 <p id='n127' class='pln'><a href='#n127'>127</a></p>
 <p id='n128' class='pln'><a href='#n128'>128</a></p>
-<p id='n129' class='pln'><a href='#n129'>129</a></p>
+<p id='n129' class='stm run hide_run'><a href='#n129'>129</a></p>
 <p id='n130' class='pln'><a href='#n130'>130</a></p>
 <p id='n131' class='pln'><a href='#n131'>131</a></p>
 <p id='n132' class='pln'><a href='#n132'>132</a></p>
@@ -224,125 +224,125 @@ <h2 class='stats'>
 <p id='n161' class='pln'><a href='#n161'>161</a></p>
 <p id='n162' class='pln'><a href='#n162'>162</a></p>
 <p id='n163' class='pln'><a href='#n163'>163</a></p>
-<p id='n164' class='stm run hide_run'><a href='#n164'>164</a></p>
+<p id='n164' class='pln'><a href='#n164'>164</a></p>
 <p id='n165' class='pln'><a href='#n165'>165</a></p>
 <p id='n166' class='pln'><a href='#n166'>166</a></p>
-<p id='n167' class='pln'><a href='#n167'>167</a></p>
+<p id='n167' class='stm run hide_run'><a href='#n167'>167</a></p>
 <p id='n168' class='pln'><a href='#n168'>168</a></p>
 <p id='n169' class='pln'><a href='#n169'>169</a></p>
 <p id='n170' class='pln'><a href='#n170'>170</a></p>
 <p id='n171' class='pln'><a href='#n171'>171</a></p>
 <p id='n172' class='pln'><a href='#n172'>172</a></p>
-<p id='n173' class='stm run hide_run'><a href='#n173'>173</a></p>
-<p id='n174' class='stm run hide_run'><a href='#n174'>174</a></p>
-<p id='n175' class='stm run hide_run'><a href='#n175'>175</a></p>
+<p id='n173' class='pln'><a href='#n173'>173</a></p>
+<p id='n174' class='pln'><a href='#n174'>174</a></p>
+<p id='n175' class='pln'><a href='#n175'>175</a></p>
 <p id='n176' class='stm run hide_run'><a href='#n176'>176</a></p>
-<p id='n177' class='pln'><a href='#n177'>177</a></p>
-<p id='n178' class='pln'><a href='#n178'>178</a></p>
-<p id='n179' class='pln'><a href='#n179'>179</a></p>
-<p id='n180' class='stm run hide_run'><a href='#n180'>180</a></p>
+<p id='n177' class='stm run hide_run'><a href='#n177'>177</a></p>
+<p id='n178' class='stm run hide_run'><a href='#n178'>178</a></p>
+<p id='n179' class='stm run hide_run'><a href='#n179'>179</a></p>
+<p id='n180' class='pln'><a href='#n180'>180</a></p>
 <p id='n181' class='pln'><a href='#n181'>181</a></p>
-<p id='n182' class='stm run hide_run'><a href='#n182'>182</a></p>
+<p id='n182' class='pln'><a href='#n182'>182</a></p>
 <p id='n183' class='stm run hide_run'><a href='#n183'>183</a></p>
 <p id='n184' class='pln'><a href='#n184'>184</a></p>
-<p id='n185' class='pln'><a href='#n185'>185</a></p>
-<p id='n186' class='pln'><a href='#n186'>186</a></p>
-<p id='n187' class='stm run hide_run'><a href='#n187'>187</a></p>
-<p id='n188' class='stm run hide_run'><a href='#n188'>188</a></p>
+<p id='n185' class='stm run hide_run'><a href='#n185'>185</a></p>
+<p id='n186' class='stm run hide_run'><a href='#n186'>186</a></p>
+<p id='n187' class='pln'><a href='#n187'>187</a></p>
+<p id='n188' class='pln'><a href='#n188'>188</a></p>
 <p id='n189' class='pln'><a href='#n189'>189</a></p>
-<p id='n190' class='pln'><a href='#n190'>190</a></p>
+<p id='n190' class='stm run hide_run'><a href='#n190'>190</a></p>
 <p id='n191' class='stm run hide_run'><a href='#n191'>191</a></p>
 <p id='n192' class='pln'><a href='#n192'>192</a></p>
 <p id='n193' class='pln'><a href='#n193'>193</a></p>
-<p id='n194' class='pln'><a href='#n194'>194</a></p>
+<p id='n194' class='stm run hide_run'><a href='#n194'>194</a></p>
 <p id='n195' class='pln'><a href='#n195'>195</a></p>
 <p id='n196' class='pln'><a href='#n196'>196</a></p>
 <p id='n197' class='pln'><a href='#n197'>197</a></p>
 <p id='n198' class='pln'><a href='#n198'>198</a></p>
-<p id='n199' class='stm run hide_run'><a href='#n199'>199</a></p>
-<p id='n200' class='stm run hide_run'><a href='#n200'>200</a></p>
+<p id='n199' class='pln'><a href='#n199'>199</a></p>
+<p id='n200' class='pln'><a href='#n200'>200</a></p>
 <p id='n201' class='pln'><a href='#n201'>201</a></p>
 <p id='n202' class='stm run hide_run'><a href='#n202'>202</a></p>
 <p id='n203' class='stm run hide_run'><a href='#n203'>203</a></p>
-<p id='n204' class='stm run hide_run'><a href='#n204'>204</a></p>
+<p id='n204' class='pln'><a href='#n204'>204</a></p>
 <p id='n205' class='stm run hide_run'><a href='#n205'>205</a></p>
 <p id='n206' class='stm run hide_run'><a href='#n206'>206</a></p>
-<p id='n207' class='pln'><a href='#n207'>207</a></p>
-<p id='n208' class='pln'><a href='#n208'>208</a></p>
-<p id='n209' class='pln'><a href='#n209'>209</a></p>
-<p id='n210' class='stm run hide_run'><a href='#n210'>210</a></p>
+<p id='n207' class='stm run hide_run'><a href='#n207'>207</a></p>
+<p id='n208' class='stm run hide_run'><a href='#n208'>208</a></p>
+<p id='n209' class='stm run hide_run'><a href='#n209'>209</a></p>
+<p id='n210' class='pln'><a href='#n210'>210</a></p>
 <p id='n211' class='pln'><a href='#n211'>211</a></p>
-<p id='n212' class='stm run hide_run'><a href='#n212'>212</a></p>
+<p id='n212' class='pln'><a href='#n212'>212</a></p>
 <p id='n213' class='stm run hide_run'><a href='#n213'>213</a></p>
 <p id='n214' class='pln'><a href='#n214'>214</a></p>
-<p id='n215' class='pln'><a href='#n215'>215</a></p>
-<p id='n216' class='pln'><a href='#n216'>216</a></p>
+<p id='n215' class='stm run hide_run'><a href='#n215'>215</a></p>
+<p id='n216' class='stm run hide_run'><a href='#n216'>216</a></p>
 <p id='n217' class='pln'><a href='#n217'>217</a></p>
-<p id='n218' class='stm run hide_run'><a href='#n218'>218</a></p>
-<p id='n219' class='stm run hide_run'><a href='#n219'>219</a></p>
+<p id='n218' class='pln'><a href='#n218'>218</a></p>
+<p id='n219' class='pln'><a href='#n219'>219</a></p>
 <p id='n220' class='pln'><a href='#n220'>220</a></p>
 <p id='n221' class='stm run hide_run'><a href='#n221'>221</a></p>
 <p id='n222' class='stm run hide_run'><a href='#n222'>222</a></p>
-<p id='n223' class='stm run hide_run'><a href='#n223'>223</a></p>
+<p id='n223' class='pln'><a href='#n223'>223</a></p>
 <p id='n224' class='stm run hide_run'><a href='#n224'>224</a></p>
 <p id='n225' class='stm run hide_run'><a href='#n225'>225</a></p>
-<p id='n226' class='pln'><a href='#n226'>226</a></p>
+<p id='n226' class='stm run hide_run'><a href='#n226'>226</a></p>
 <p id='n227' class='stm run hide_run'><a href='#n227'>227</a></p>
 <p id='n228' class='stm run hide_run'><a href='#n228'>228</a></p>
-<p id='n229' class='stm run hide_run'><a href='#n229'>229</a></p>
+<p id='n229' class='pln'><a href='#n229'>229</a></p>
 <p id='n230' class='stm run hide_run'><a href='#n230'>230</a></p>
-<p id='n231' class='pln'><a href='#n231'>231</a></p>
+<p id='n231' class='stm run hide_run'><a href='#n231'>231</a></p>
 <p id='n232' class='stm run hide_run'><a href='#n232'>232</a></p>
 <p id='n233' class='stm run hide_run'><a href='#n233'>233</a></p>
-<p id='n234' class='stm run hide_run'><a href='#n234'>234</a></p>
+<p id='n234' class='pln'><a href='#n234'>234</a></p>
 <p id='n235' class='stm run hide_run'><a href='#n235'>235</a></p>
-<p id='n236' class='pln'><a href='#n236'>236</a></p>
+<p id='n236' class='stm run hide_run'><a href='#n236'>236</a></p>
 <p id='n237' class='stm run hide_run'><a href='#n237'>237</a></p>
 <p id='n238' class='stm run hide_run'><a href='#n238'>238</a></p>
-<p id='n239' class='stm run hide_run'><a href='#n239'>239</a></p>
+<p id='n239' class='pln'><a href='#n239'>239</a></p>
 <p id='n240' class='stm run hide_run'><a href='#n240'>240</a></p>
-<p id='n241' class='pln'><a href='#n241'>241</a></p>
+<p id='n241' class='stm run hide_run'><a href='#n241'>241</a></p>
 <p id='n242' class='stm run hide_run'><a href='#n242'>242</a></p>
 <p id='n243' class='stm run hide_run'><a href='#n243'>243</a></p>
-<p id='n244' class='stm run hide_run'><a href='#n244'>244</a></p>
+<p id='n244' class='pln'><a href='#n244'>244</a></p>
 <p id='n245' class='stm run hide_run'><a href='#n245'>245</a></p>
 <p id='n246' class='stm run hide_run'><a href='#n246'>246</a></p>
 <p id='n247' class='stm run hide_run'><a href='#n247'>247</a></p>
 <p id='n248' class='stm run hide_run'><a href='#n248'>248</a></p>
-<p id='n249' class='pln'><a href='#n249'>249</a></p>
+<p id='n249' class='stm run hide_run'><a href='#n249'>249</a></p>
 <p id='n250' class='stm run hide_run'><a href='#n250'>250</a></p>
 <p id='n251' class='stm run hide_run'><a href='#n251'>251</a></p>
-<p id='n252' class='stm run hide_run'><a href='#n252'>252</a></p>
+<p id='n252' class='pln'><a href='#n252'>252</a></p>
 <p id='n253' class='stm run hide_run'><a href='#n253'>253</a></p>
-<p id='n254' class='pln'><a href='#n254'>254</a></p>
+<p id='n254' class='stm run hide_run'><a href='#n254'>254</a></p>
 <p id='n255' class='stm run hide_run'><a href='#n255'>255</a></p>
-<p id='n256' class='pln'><a href='#n256'>256</a></p>
-<p id='n257' class='stm run hide_run'><a href='#n257'>257</a></p>
-<p id='n258' class='pln'><a href='#n258'>258</a></p>
-<p id='n259' class='stm run hide_run'><a href='#n259'>259</a></p>
+<p id='n256' class='stm run hide_run'><a href='#n256'>256</a></p>
+<p id='n257' class='pln'><a href='#n257'>257</a></p>
+<p id='n258' class='stm run hide_run'><a href='#n258'>258</a></p>
+<p id='n259' class='pln'><a href='#n259'>259</a></p>
 <p id='n260' class='stm run hide_run'><a href='#n260'>260</a></p>
 <p id='n261' class='pln'><a href='#n261'>261</a></p>
-<p id='n262' class='pln'><a href='#n262'>262</a></p>
+<p id='n262' class='stm run hide_run'><a href='#n262'>262</a></p>
 <p id='n263' class='stm run hide_run'><a href='#n263'>263</a></p>
-<p id='n264' class='stm run hide_run'><a href='#n264'>264</a></p>
-<p id='n265' class='stm run hide_run'><a href='#n265'>265</a></p>
-<p id='n266' class='pln'><a href='#n266'>266</a></p>
-<p id='n267' class='pln'><a href='#n267'>267</a></p>
+<p id='n264' class='pln'><a href='#n264'>264</a></p>
+<p id='n265' class='pln'><a href='#n265'>265</a></p>
+<p id='n266' class='stm run hide_run'><a href='#n266'>266</a></p>
+<p id='n267' class='stm run hide_run'><a href='#n267'>267</a></p>
 <p id='n268' class='stm run hide_run'><a href='#n268'>268</a></p>
-<p id='n269' class='stm run hide_run'><a href='#n269'>269</a></p>
-<p id='n270' class='stm run hide_run'><a href='#n270'>270</a></p>
+<p id='n269' class='pln'><a href='#n269'>269</a></p>
+<p id='n270' class='pln'><a href='#n270'>270</a></p>
 <p id='n271' class='stm run hide_run'><a href='#n271'>271</a></p>
-<p id='n272' class='pln'><a href='#n272'>272</a></p>
+<p id='n272' class='stm run hide_run'><a href='#n272'>272</a></p>
 <p id='n273' class='stm run hide_run'><a href='#n273'>273</a></p>
 <p id='n274' class='stm run hide_run'><a href='#n274'>274</a></p>
-<p id='n275' class='stm run hide_run'><a href='#n275'>275</a></p>
+<p id='n275' class='pln'><a href='#n275'>275</a></p>
 <p id='n276' class='stm run hide_run'><a href='#n276'>276</a></p>
-<p id='n277' class='pln'><a href='#n277'>277</a></p>
+<p id='n277' class='stm run hide_run'><a href='#n277'>277</a></p>
 <p id='n278' class='stm run hide_run'><a href='#n278'>278</a></p>
 <p id='n279' class='stm run hide_run'><a href='#n279'>279</a></p>
 <p id='n280' class='pln'><a href='#n280'>280</a></p>
-<p id='n281' class='pln'><a href='#n281'>281</a></p>
-<p id='n282' class='pln'><a href='#n282'>282</a></p>
+<p id='n281' class='stm run hide_run'><a href='#n281'>281</a></p>
+<p id='n282' class='stm run hide_run'><a href='#n282'>282</a></p>
 <p id='n283' class='pln'><a href='#n283'>283</a></p>
 <p id='n284' class='pln'><a href='#n284'>284</a></p>
 <p id='n285' class='pln'><a href='#n285'>285</a></p>
@@ -359,13 +359,13 @@ <h2 class='stats'>
 <p id='n296' class='pln'><a href='#n296'>296</a></p>
 <p id='n297' class='pln'><a href='#n297'>297</a></p>
 <p id='n298' class='pln'><a href='#n298'>298</a></p>
-<p id='n299' class='stm run hide_run'><a href='#n299'>299</a></p>
-<p id='n300' class='stm run hide_run'><a href='#n300'>300</a></p>
-<p id='n301' class='stm run hide_run'><a href='#n301'>301</a></p>
+<p id='n299' class='pln'><a href='#n299'>299</a></p>
+<p id='n300' class='pln'><a href='#n300'>300</a></p>
+<p id='n301' class='pln'><a href='#n301'>301</a></p>
 <p id='n302' class='stm run hide_run'><a href='#n302'>302</a></p>
-<p id='n303' class='pln'><a href='#n303'>303</a></p>
-<p id='n304' class='pln'><a href='#n304'>304</a></p>
-<p id='n305' class='pln'><a href='#n305'>305</a></p>
+<p id='n303' class='stm run hide_run'><a href='#n303'>303</a></p>
+<p id='n304' class='stm run hide_run'><a href='#n304'>304</a></p>
+<p id='n305' class='stm run hide_run'><a href='#n305'>305</a></p>
 <p id='n306' class='pln'><a href='#n306'>306</a></p>
 <p id='n307' class='pln'><a href='#n307'>307</a></p>
 <p id='n308' class='pln'><a href='#n308'>308</a></p>
@@ -377,234 +377,234 @@ <h2 class='stats'>
 <p id='n314' class='pln'><a href='#n314'>314</a></p>
 <p id='n315' class='pln'><a href='#n315'>315</a></p>
 <p id='n316' class='pln'><a href='#n316'>316</a></p>
-<p id='n317' class='stm run hide_run'><a href='#n317'>317</a></p>
-<p id='n318' class='stm run hide_run'><a href='#n318'>318</a></p>
-<p id='n319' class='stm run hide_run'><a href='#n319'>319</a></p>
-<p id='n320' class='pln'><a href='#n320'>320</a></p>
-<p id='n321' class='pln'><a href='#n321'>321</a></p>
-<p id='n322' class='pln'><a href='#n322'>322</a></p>
-<p id='n323' class='stm run hide_run'><a href='#n323'>323</a></p>
+<p id='n317' class='pln'><a href='#n317'>317</a></p>
+<p id='n318' class='pln'><a href='#n318'>318</a></p>
+<p id='n319' class='pln'><a href='#n319'>319</a></p>
+<p id='n320' class='stm run hide_run'><a href='#n320'>320</a></p>
+<p id='n321' class='stm run hide_run'><a href='#n321'>321</a></p>
+<p id='n322' class='stm run hide_run'><a href='#n322'>322</a></p>
+<p id='n323' class='pln'><a href='#n323'>323</a></p>
 <p id='n324' class='pln'><a href='#n324'>324</a></p>
 <p id='n325' class='pln'><a href='#n325'>325</a></p>
-<p id='n326' class='pln'><a href='#n326'>326</a></p>
+<p id='n326' class='stm run hide_run'><a href='#n326'>326</a></p>
 <p id='n327' class='pln'><a href='#n327'>327</a></p>
 <p id='n328' class='pln'><a href='#n328'>328</a></p>
 <p id='n329' class='pln'><a href='#n329'>329</a></p>
 <p id='n330' class='pln'><a href='#n330'>330</a></p>
-<p id='n331' class='stm run hide_run'><a href='#n331'>331</a></p>
-<p id='n332' class='stm run hide_run'><a href='#n332'>332</a></p>
-<p id='n333' class='stm run hide_run'><a href='#n333'>333</a></p>
+<p id='n331' class='pln'><a href='#n331'>331</a></p>
+<p id='n332' class='pln'><a href='#n332'>332</a></p>
+<p id='n333' class='pln'><a href='#n333'>333</a></p>
 <p id='n334' class='stm run hide_run'><a href='#n334'>334</a></p>
 <p id='n335' class='stm run hide_run'><a href='#n335'>335</a></p>
 <p id='n336' class='stm run hide_run'><a href='#n336'>336</a></p>
 <p id='n337' class='stm run hide_run'><a href='#n337'>337</a></p>
 <p id='n338' class='stm run hide_run'><a href='#n338'>338</a></p>
-<p id='n339' class='pln'><a href='#n339'>339</a></p>
+<p id='n339' class='stm run hide_run'><a href='#n339'>339</a></p>
 <p id='n340' class='stm run hide_run'><a href='#n340'>340</a></p>
-<p id='n341' class='pln'><a href='#n341'>341</a></p>
+<p id='n341' class='stm run hide_run'><a href='#n341'>341</a></p>
 <p id='n342' class='pln'><a href='#n342'>342</a></p>
-<p id='n343' class='pln'><a href='#n343'>343</a></p>
+<p id='n343' class='stm run hide_run'><a href='#n343'>343</a></p>
 <p id='n344' class='pln'><a href='#n344'>344</a></p>
-<p id='n345' class='stm run hide_run'><a href='#n345'>345</a></p>
+<p id='n345' class='pln'><a href='#n345'>345</a></p>
 <p id='n346' class='pln'><a href='#n346'>346</a></p>
 <p id='n347' class='pln'><a href='#n347'>347</a></p>
-<p id='n348' class='pln'><a href='#n348'>348</a></p>
+<p id='n348' class='stm run hide_run'><a href='#n348'>348</a></p>
 <p id='n349' class='pln'><a href='#n349'>349</a></p>
 <p id='n350' class='pln'><a href='#n350'>350</a></p>
-<p id='n351' class='stm mis'><a href='#n351'>351</a></p>
-<p id='n352' class='stm mis'><a href='#n352'>352</a></p>
-<p id='n353' class='stm mis'><a href='#n353'>353</a></p>
-<p id='n354' class='stm mis'><a href='#n354'>354</a></p>
-<p id='n355' class='stm mis'><a href='#n355'>355</a></p>
-<p id='n356' class='stm mis'><a href='#n356'>356</a></p>
-<p id='n357' class='stm mis'><a href='#n357'>357</a></p>
-<p id='n358' class='stm mis'><a href='#n358'>358</a></p>
+<p id='n351' class='pln'><a href='#n351'>351</a></p>
+<p id='n352' class='pln'><a href='#n352'>352</a></p>
+<p id='n353' class='pln'><a href='#n353'>353</a></p>
+<p id='n354' class='pln'><a href='#n354'>354</a></p>
+<p id='n355' class='pln'><a href='#n355'>355</a></p>
+<p id='n356' class='pln'><a href='#n356'>356</a></p>
+<p id='n357' class='pln'><a href='#n357'>357</a></p>
+<p id='n358' class='pln'><a href='#n358'>358</a></p>
 <p id='n359' class='pln'><a href='#n359'>359</a></p>
 <p id='n360' class='stm run hide_run'><a href='#n360'>360</a></p>
-<p id='n361' class='pln'><a href='#n361'>361</a></p>
-<p id='n362' class='pln'><a href='#n362'>362</a></p>
-<p id='n363' class='pln'><a href='#n363'>363</a></p>
-<p id='n364' class='pln'><a href='#n364'>364</a></p>
-<p id='n365' class='pln'><a href='#n365'>365</a></p>
-<p id='n366' class='pln'><a href='#n366'>366</a></p>
-<p id='n367' class='pln'><a href='#n367'>367</a></p>
+<p id='n361' class='stm run hide_run'><a href='#n361'>361</a></p>
+<p id='n362' class='stm run hide_run'><a href='#n362'>362</a></p>
+<p id='n363' class='stm run hide_run'><a href='#n363'>363</a></p>
+<p id='n364' class='stm run hide_run'><a href='#n364'>364</a></p>
+<p id='n365' class='stm run hide_run'><a href='#n365'>365</a></p>
+<p id='n366' class='stm run hide_run'><a href='#n366'>366</a></p>
+<p id='n367' class='stm run hide_run'><a href='#n367'>367</a></p>
 <p id='n368' class='pln'><a href='#n368'>368</a></p>
-<p id='n369' class='pln'><a href='#n369'>369</a></p>
-<p id='n370' class='pln'><a href='#n370'>370</a></p>
+<p id='n369' class='stm run hide_run'><a href='#n369'>369</a></p>
+<p id='n370' class='stm run hide_run'><a href='#n370'>370</a></p>
 <p id='n371' class='pln'><a href='#n371'>371</a></p>
-<p id='n372' class='pln'><a href='#n372'>372</a></p>
+<p id='n372' class='stm run hide_run'><a href='#n372'>372</a></p>
 <p id='n373' class='pln'><a href='#n373'>373</a></p>
 <p id='n374' class='pln'><a href='#n374'>374</a></p>
-<p id='n375' class='pln'><a href='#n375'>375</a></p>
+<p id='n375' class='stm run hide_run'><a href='#n375'>375</a></p>
 <p id='n376' class='pln'><a href='#n376'>376</a></p>
 <p id='n377' class='pln'><a href='#n377'>377</a></p>
-<p id='n378' class='stm mis'><a href='#n378'>378</a></p>
-<p id='n379' class='stm mis'><a href='#n379'>379</a></p>
-<p id='n380' class='stm mis'><a href='#n380'>380</a></p>
+<p id='n378' class='pln'><a href='#n378'>378</a></p>
+<p id='n379' class='pln'><a href='#n379'>379</a></p>
+<p id='n380' class='pln'><a href='#n380'>380</a></p>
 <p id='n381' class='pln'><a href='#n381'>381</a></p>
-<p id='n382' class='stm run hide_run'><a href='#n382'>382</a></p>
+<p id='n382' class='pln'><a href='#n382'>382</a></p>
 <p id='n383' class='pln'><a href='#n383'>383</a></p>
-<p id='n384' class='stm mis'><a href='#n384'>384</a></p>
-<p id='n385' class='stm mis'><a href='#n385'>385</a></p>
-<p id='n386' class='stm mis'><a href='#n386'>386</a></p>
-<p id='n387' class='stm mis'><a href='#n387'>387</a></p>
-<p id='n388' class='stm mis'><a href='#n388'>388</a></p>
+<p id='n384' class='pln'><a href='#n384'>384</a></p>
+<p id='n385' class='pln'><a href='#n385'>385</a></p>
+<p id='n386' class='pln'><a href='#n386'>386</a></p>
+<p id='n387' class='pln'><a href='#n387'>387</a></p>
+<p id='n388' class='pln'><a href='#n388'>388</a></p>
 <p id='n389' class='pln'><a href='#n389'>389</a></p>
-<p id='n390' class='stm mis'><a href='#n390'>390</a></p>
-<p id='n391' class='stm mis'><a href='#n391'>391</a></p>
-<p id='n392' class='stm mis'><a href='#n392'>392</a></p>
-<p id='n393' class='stm mis'><a href='#n393'>393</a></p>
-<p id='n394' class='stm mis'><a href='#n394'>394</a></p>
-<p id='n395' class='pln'><a href='#n395'>395</a></p>
-<p id='n396' class='stm run hide_run'><a href='#n396'>396</a></p>
-<p id='n397' class='pln'><a href='#n397'>397</a></p>
+<p id='n390' class='pln'><a href='#n390'>390</a></p>
+<p id='n391' class='pln'><a href='#n391'>391</a></p>
+<p id='n392' class='pln'><a href='#n392'>392</a></p>
+<p id='n393' class='stm run hide_run'><a href='#n393'>393</a></p>
+<p id='n394' class='stm run hide_run'><a href='#n394'>394</a></p>
+<p id='n395' class='stm run hide_run'><a href='#n395'>395</a></p>
+<p id='n396' class='pln'><a href='#n396'>396</a></p>
+<p id='n397' class='stm run hide_run'><a href='#n397'>397</a></p>
 <p id='n398' class='pln'><a href='#n398'>398</a></p>
-<p id='n399' class='pln'><a href='#n399'>399</a></p>
-<p id='n400' class='pln'><a href='#n400'>400</a></p>
-<p id='n401' class='pln'><a href='#n401'>401</a></p>
-<p id='n402' class='pln'><a href='#n402'>402</a></p>
-<p id='n403' class='pln'><a href='#n403'>403</a></p>
+<p id='n399' class='stm run hide_run'><a href='#n399'>399</a></p>
+<p id='n400' class='stm run hide_run'><a href='#n400'>400</a></p>
+<p id='n401' class='stm run hide_run'><a href='#n401'>401</a></p>
+<p id='n402' class='stm run hide_run'><a href='#n402'>402</a></p>
+<p id='n403' class='stm run hide_run'><a href='#n403'>403</a></p>
 <p id='n404' class='pln'><a href='#n404'>404</a></p>
-<p id='n405' class='pln'><a href='#n405'>405</a></p>
-<p id='n406' class='pln'><a href='#n406'>406</a></p>
-<p id='n407' class='pln'><a href='#n407'>407</a></p>
-<p id='n408' class='stm run hide_run'><a href='#n408'>408</a></p>
+<p id='n405' class='stm run hide_run'><a href='#n405'>405</a></p>
+<p id='n406' class='stm run hide_run'><a href='#n406'>406</a></p>
+<p id='n407' class='stm mis'><a href='#n407'>407</a></p>
+<p id='n408' class='stm mis'><a href='#n408'>408</a></p>
 <p id='n409' class='stm run hide_run'><a href='#n409'>409</a></p>
-<p id='n410' class='stm run hide_run'><a href='#n410'>410</a></p>
+<p id='n410' class='pln'><a href='#n410'>410</a></p>
 <p id='n411' class='stm run hide_run'><a href='#n411'>411</a></p>
-<p id='n412' class='stm run hide_run'><a href='#n412'>412</a></p>
-<p id='n413' class='stm run hide_run'><a href='#n413'>413</a></p>
-<p id='n414' class='stm run hide_run'><a href='#n414'>414</a></p>
-<p id='n415' class='stm run hide_run'><a href='#n415'>415</a></p>
-<p id='n416' class='stm run hide_run'><a href='#n416'>416</a></p>
-<p id='n417' class='stm run hide_run'><a href='#n417'>417</a></p>
-<p id='n418' class='stm run hide_run'><a href='#n418'>418</a></p>
-<p id='n419' class='stm run hide_run'><a href='#n419'>419</a></p>
-<p id='n420' class='stm run hide_run'><a href='#n420'>420</a></p>
-<p id='n421' class='stm run hide_run'><a href='#n421'>421</a></p>
+<p id='n412' class='pln'><a href='#n412'>412</a></p>
+<p id='n413' class='pln'><a href='#n413'>413</a></p>
+<p id='n414' class='pln'><a href='#n414'>414</a></p>
+<p id='n415' class='pln'><a href='#n415'>415</a></p>
+<p id='n416' class='pln'><a href='#n416'>416</a></p>
+<p id='n417' class='pln'><a href='#n417'>417</a></p>
+<p id='n418' class='pln'><a href='#n418'>418</a></p>
+<p id='n419' class='pln'><a href='#n419'>419</a></p>
+<p id='n420' class='pln'><a href='#n420'>420</a></p>
+<p id='n421' class='pln'><a href='#n421'>421</a></p>
 <p id='n422' class='pln'><a href='#n422'>422</a></p>
-<p id='n423' class='stm mis'><a href='#n423'>423</a></p>
-<p id='n424' class='pln'><a href='#n424'>424</a></p>
-<p id='n425' class='pln'><a href='#n425'>425</a></p>
-<p id='n426' class='pln'><a href='#n426'>426</a></p>
-<p id='n427' class='pln'><a href='#n427'>427</a></p>
-<p id='n428' class='pln'><a href='#n428'>428</a></p>
+<p id='n423' class='stm run hide_run'><a href='#n423'>423</a></p>
+<p id='n424' class='stm run hide_run'><a href='#n424'>424</a></p>
+<p id='n425' class='stm run hide_run'><a href='#n425'>425</a></p>
+<p id='n426' class='stm run hide_run'><a href='#n426'>426</a></p>
+<p id='n427' class='stm run hide_run'><a href='#n427'>427</a></p>
+<p id='n428' class='stm run hide_run'><a href='#n428'>428</a></p>
 <p id='n429' class='stm run hide_run'><a href='#n429'>429</a></p>
-<p id='n430' class='pln'><a href='#n430'>430</a></p>
-<p id='n431' class='pln'><a href='#n431'>431</a></p>
-<p id='n432' class='pln'><a href='#n432'>432</a></p>
-<p id='n433' class='pln'><a href='#n433'>433</a></p>
-<p id='n434' class='pln'><a href='#n434'>434</a></p>
-<p id='n435' class='pln'><a href='#n435'>435</a></p>
-<p id='n436' class='pln'><a href='#n436'>436</a></p>
+<p id='n430' class='stm run hide_run'><a href='#n430'>430</a></p>
+<p id='n431' class='stm run hide_run'><a href='#n431'>431</a></p>
+<p id='n432' class='stm run hide_run'><a href='#n432'>432</a></p>
+<p id='n433' class='stm run hide_run'><a href='#n433'>433</a></p>
+<p id='n434' class='stm run hide_run'><a href='#n434'>434</a></p>
+<p id='n435' class='stm run hide_run'><a href='#n435'>435</a></p>
+<p id='n436' class='stm run hide_run'><a href='#n436'>436</a></p>
 <p id='n437' class='pln'><a href='#n437'>437</a></p>
-<p id='n438' class='pln'><a href='#n438'>438</a></p>
+<p id='n438' class='stm mis'><a href='#n438'>438</a></p>
 <p id='n439' class='pln'><a href='#n439'>439</a></p>
 <p id='n440' class='pln'><a href='#n440'>440</a></p>
 <p id='n441' class='pln'><a href='#n441'>441</a></p>
 <p id='n442' class='pln'><a href='#n442'>442</a></p>
 <p id='n443' class='pln'><a href='#n443'>443</a></p>
-<p id='n444' class='stm mis'><a href='#n444'>444</a></p>
-<p id='n445' class='stm mis'><a href='#n445'>445</a></p>
-<p id='n446' class='stm mis'><a href='#n446'>446</a></p>
-<p id='n447' class='stm mis'><a href='#n447'>447</a></p>
+<p id='n444' class='stm run hide_run'><a href='#n444'>444</a></p>
+<p id='n445' class='pln'><a href='#n445'>445</a></p>
+<p id='n446' class='pln'><a href='#n446'>446</a></p>
+<p id='n447' class='pln'><a href='#n447'>447</a></p>
 <p id='n448' class='pln'><a href='#n448'>448</a></p>
 <p id='n449' class='pln'><a href='#n449'>449</a></p>
 <p id='n450' class='pln'><a href='#n450'>450</a></p>
-<p id='n451' class='stm mis'><a href='#n451'>451</a></p>
-<p id='n452' class='stm mis'><a href='#n452'>452</a></p>
+<p id='n451' class='pln'><a href='#n451'>451</a></p>
+<p id='n452' class='pln'><a href='#n452'>452</a></p>
 <p id='n453' class='pln'><a href='#n453'>453</a></p>
 <p id='n454' class='pln'><a href='#n454'>454</a></p>
 <p id='n455' class='pln'><a href='#n455'>455</a></p>
 <p id='n456' class='pln'><a href='#n456'>456</a></p>
-<p id='n457' class='stm mis'><a href='#n457'>457</a></p>
-<p id='n458' class='stm mis'><a href='#n458'>458</a></p>
-<p id='n459' class='pln'><a href='#n459'>459</a></p>
-<p id='n460' class='pln'><a href='#n460'>460</a></p>
+<p id='n457' class='pln'><a href='#n457'>457</a></p>
+<p id='n458' class='pln'><a href='#n458'>458</a></p>
+<p id='n459' class='stm run hide_run'><a href='#n459'>459</a></p>
+<p id='n460' class='stm run hide_run'><a href='#n460'>460</a></p>
 <p id='n461' class='stm mis'><a href='#n461'>461</a></p>
-<p id='n462' class='stm mis'><a href='#n462'>462</a></p>
+<p id='n462' class='stm run hide_run'><a href='#n462'>462</a></p>
 <p id='n463' class='pln'><a href='#n463'>463</a></p>
-<p id='n464' class='stm run hide_run'><a href='#n464'>464</a></p>
-<p id='n465' class='stm mis'><a href='#n465'>465</a></p>
-<p id='n466' class='stm mis'><a href='#n466'>466</a></p>
-<p id='n467' class='stm mis'><a href='#n467'>467</a></p>
-<p id='n468' class='stm mis'><a href='#n468'>468</a></p>
-<p id='n469' class='stm mis'><a href='#n469'>469</a></p>
+<p id='n464' class='pln'><a href='#n464'>464</a></p>
+<p id='n465' class='pln'><a href='#n465'>465</a></p>
+<p id='n466' class='stm run hide_run'><a href='#n466'>466</a></p>
+<p id='n467' class='stm run hide_run'><a href='#n467'>467</a></p>
+<p id='n468' class='pln'><a href='#n468'>468</a></p>
+<p id='n469' class='pln'><a href='#n469'>469</a></p>
 <p id='n470' class='pln'><a href='#n470'>470</a></p>
-<p id='n471' class='stm mis'><a href='#n471'>471</a></p>
-<p id='n472' class='stm mis'><a href='#n472'>472</a></p>
-<p id='n473' class='stm mis'><a href='#n473'>473</a></p>
-<p id='n474' class='stm mis'><a href='#n474'>474</a></p>
-<p id='n475' class='stm mis'><a href='#n475'>475</a></p>
-<p id='n476' class='stm mis'><a href='#n476'>476</a></p>
-<p id='n477' class='pln'><a href='#n477'>477</a></p>
+<p id='n471' class='pln'><a href='#n471'>471</a></p>
+<p id='n472' class='stm run hide_run'><a href='#n472'>472</a></p>
+<p id='n473' class='stm run hide_run'><a href='#n473'>473</a></p>
+<p id='n474' class='pln'><a href='#n474'>474</a></p>
+<p id='n475' class='pln'><a href='#n475'>475</a></p>
+<p id='n476' class='stm run hide_run'><a href='#n476'>476</a></p>
+<p id='n477' class='stm run hide_run'><a href='#n477'>477</a></p>
 <p id='n478' class='pln'><a href='#n478'>478</a></p>
 <p id='n479' class='stm run hide_run'><a href='#n479'>479</a></p>
-<p id='n480' class='pln'><a href='#n480'>480</a></p>
-<p id='n481' class='pln'><a href='#n481'>481</a></p>
-<p id='n482' class='pln'><a href='#n482'>482</a></p>
-<p id='n483' class='pln'><a href='#n483'>483</a></p>
-<p id='n484' class='pln'><a href='#n484'>484</a></p>
+<p id='n480' class='stm run hide_run'><a href='#n480'>480</a></p>
+<p id='n481' class='stm mis'><a href='#n481'>481</a></p>
+<p id='n482' class='stm mis'><a href='#n482'>482</a></p>
+<p id='n483' class='stm mis'><a href='#n483'>483</a></p>
+<p id='n484' class='stm mis'><a href='#n484'>484</a></p>
 <p id='n485' class='pln'><a href='#n485'>485</a></p>
-<p id='n486' class='pln'><a href='#n486'>486</a></p>
-<p id='n487' class='pln'><a href='#n487'>487</a></p>
-<p id='n488' class='pln'><a href='#n488'>488</a></p>
-<p id='n489' class='pln'><a href='#n489'>489</a></p>
-<p id='n490' class='pln'><a href='#n490'>490</a></p>
+<p id='n486' class='stm mis'><a href='#n486'>486</a></p>
+<p id='n487' class='stm mis'><a href='#n487'>487</a></p>
+<p id='n488' class='stm run hide_run'><a href='#n488'>488</a></p>
+<p id='n489' class='stm run hide_run'><a href='#n489'>489</a></p>
+<p id='n490' class='stm run hide_run'><a href='#n490'>490</a></p>
 <p id='n491' class='stm run hide_run'><a href='#n491'>491</a></p>
-<p id='n492' class='stm mis'><a href='#n492'>492</a></p>
-<p id='n493' class='stm run hide_run'><a href='#n493'>493</a></p>
+<p id='n492' class='pln'><a href='#n492'>492</a></p>
+<p id='n493' class='pln'><a href='#n493'>493</a></p>
 <p id='n494' class='stm run hide_run'><a href='#n494'>494</a></p>
-<p id='n495' class='stm run hide_run'><a href='#n495'>495</a></p>
+<p id='n495' class='pln'><a href='#n495'>495</a></p>
 <p id='n496' class='pln'><a href='#n496'>496</a></p>
-<p id='n497' class='stm run hide_run'><a href='#n497'>497</a></p>
-<p id='n498' class='stm run hide_run'><a href='#n498'>498</a></p>
-<p id='n499' class='stm mis'><a href='#n499'>499</a></p>
-<p id='n500' class='stm mis'><a href='#n500'>500</a></p>
+<p id='n497' class='pln'><a href='#n497'>497</a></p>
+<p id='n498' class='pln'><a href='#n498'>498</a></p>
+<p id='n499' class='pln'><a href='#n499'>499</a></p>
+<p id='n500' class='pln'><a href='#n500'>500</a></p>
 <p id='n501' class='pln'><a href='#n501'>501</a></p>
-<p id='n502' class='stm run hide_run'><a href='#n502'>502</a></p>
-<p id='n503' class='stm run hide_run'><a href='#n503'>503</a></p>
+<p id='n502' class='pln'><a href='#n502'>502</a></p>
+<p id='n503' class='pln'><a href='#n503'>503</a></p>
 <p id='n504' class='pln'><a href='#n504'>504</a></p>
 <p id='n505' class='pln'><a href='#n505'>505</a></p>
-<p id='n506' class='pln'><a href='#n506'>506</a></p>
-<p id='n507' class='pln'><a href='#n507'>507</a></p>
-<p id='n508' class='pln'><a href='#n508'>508</a></p>
-<p id='n509' class='pln'><a href='#n509'>509</a></p>
-<p id='n510' class='pln'><a href='#n510'>510</a></p>
+<p id='n506' class='stm run hide_run'><a href='#n506'>506</a></p>
+<p id='n507' class='stm mis'><a href='#n507'>507</a></p>
+<p id='n508' class='stm run hide_run'><a href='#n508'>508</a></p>
+<p id='n509' class='stm run hide_run'><a href='#n509'>509</a></p>
+<p id='n510' class='stm run hide_run'><a href='#n510'>510</a></p>
 <p id='n511' class='pln'><a href='#n511'>511</a></p>
-<p id='n512' class='pln'><a href='#n512'>512</a></p>
-<p id='n513' class='pln'><a href='#n513'>513</a></p>
-<p id='n514' class='pln'><a href='#n514'>514</a></p>
-<p id='n515' class='pln'><a href='#n515'>515</a></p>
+<p id='n512' class='stm run hide_run'><a href='#n512'>512</a></p>
+<p id='n513' class='stm run hide_run'><a href='#n513'>513</a></p>
+<p id='n514' class='stm mis'><a href='#n514'>514</a></p>
+<p id='n515' class='stm mis'><a href='#n515'>515</a></p>
 <p id='n516' class='pln'><a href='#n516'>516</a></p>
 <p id='n517' class='stm run hide_run'><a href='#n517'>517</a></p>
 <p id='n518' class='stm run hide_run'><a href='#n518'>518</a></p>
-<p id='n519' class='stm run hide_run'><a href='#n519'>519</a></p>
-<p id='n520' class='stm run hide_run'><a href='#n520'>520</a></p>
-<p id='n521' class='stm run hide_run'><a href='#n521'>521</a></p>
-<p id='n522' class='stm run hide_run'><a href='#n522'>522</a></p>
-<p id='n523' class='stm run hide_run'><a href='#n523'>523</a></p>
-<p id='n524' class='stm run hide_run'><a href='#n524'>524</a></p>
-<p id='n525' class='stm run hide_run'><a href='#n525'>525</a></p>
+<p id='n519' class='pln'><a href='#n519'>519</a></p>
+<p id='n520' class='pln'><a href='#n520'>520</a></p>
+<p id='n521' class='pln'><a href='#n521'>521</a></p>
+<p id='n522' class='pln'><a href='#n522'>522</a></p>
+<p id='n523' class='pln'><a href='#n523'>523</a></p>
+<p id='n524' class='pln'><a href='#n524'>524</a></p>
+<p id='n525' class='pln'><a href='#n525'>525</a></p>
 <p id='n526' class='pln'><a href='#n526'>526</a></p>
 <p id='n527' class='pln'><a href='#n527'>527</a></p>
 <p id='n528' class='pln'><a href='#n528'>528</a></p>
-<p id='n529' class='stm run hide_run'><a href='#n529'>529</a></p>
+<p id='n529' class='pln'><a href='#n529'>529</a></p>
 <p id='n530' class='pln'><a href='#n530'>530</a></p>
 <p id='n531' class='pln'><a href='#n531'>531</a></p>
-<p id='n532' class='pln'><a href='#n532'>532</a></p>
-<p id='n533' class='pln'><a href='#n533'>533</a></p>
-<p id='n534' class='pln'><a href='#n534'>534</a></p>
-<p id='n535' class='pln'><a href='#n535'>535</a></p>
-<p id='n536' class='pln'><a href='#n536'>536</a></p>
-<p id='n537' class='pln'><a href='#n537'>537</a></p>
-<p id='n538' class='pln'><a href='#n538'>538</a></p>
-<p id='n539' class='pln'><a href='#n539'>539</a></p>
-<p id='n540' class='pln'><a href='#n540'>540</a></p>
+<p id='n532' class='stm run hide_run'><a href='#n532'>532</a></p>
+<p id='n533' class='stm run hide_run'><a href='#n533'>533</a></p>
+<p id='n534' class='stm run hide_run'><a href='#n534'>534</a></p>
+<p id='n535' class='stm run hide_run'><a href='#n535'>535</a></p>
+<p id='n536' class='stm run hide_run'><a href='#n536'>536</a></p>
+<p id='n537' class='stm run hide_run'><a href='#n537'>537</a></p>
+<p id='n538' class='stm run hide_run'><a href='#n538'>538</a></p>
+<p id='n539' class='stm run hide_run'><a href='#n539'>539</a></p>
+<p id='n540' class='stm run hide_run'><a href='#n540'>540</a></p>
 <p id='n541' class='pln'><a href='#n541'>541</a></p>
 <p id='n542' class='pln'><a href='#n542'>542</a></p>
 <p id='n543' class='pln'><a href='#n543'>543</a></p>
-<p id='n544' class='pln'><a href='#n544'>544</a></p>
+<p id='n544' class='stm run hide_run'><a href='#n544'>544</a></p>
 <p id='n545' class='pln'><a href='#n545'>545</a></p>
 <p id='n546' class='pln'><a href='#n546'>546</a></p>
 <p id='n547' class='pln'><a href='#n547'>547</a></p>
@@ -618,385 +618,385 @@ <h2 class='stats'>
 <p id='n555' class='pln'><a href='#n555'>555</a></p>
 <p id='n556' class='pln'><a href='#n556'>556</a></p>
 <p id='n557' class='pln'><a href='#n557'>557</a></p>
-<p id='n558' class='stm run hide_run'><a href='#n558'>558</a></p>
+<p id='n558' class='pln'><a href='#n558'>558</a></p>
 <p id='n559' class='pln'><a href='#n559'>559</a></p>
-<p id='n560' class='stm run hide_run'><a href='#n560'>560</a></p>
-<p id='n561' class='stm run hide_run'><a href='#n561'>561</a></p>
-<p id='n562' class='stm run hide_run'><a href='#n562'>562</a></p>
-<p id='n563' class='stm run hide_run'><a href='#n563'>563</a></p>
-<p id='n564' class='stm run hide_run'><a href='#n564'>564</a></p>
+<p id='n560' class='pln'><a href='#n560'>560</a></p>
+<p id='n561' class='pln'><a href='#n561'>561</a></p>
+<p id='n562' class='pln'><a href='#n562'>562</a></p>
+<p id='n563' class='pln'><a href='#n563'>563</a></p>
+<p id='n564' class='pln'><a href='#n564'>564</a></p>
 <p id='n565' class='pln'><a href='#n565'>565</a></p>
-<p id='n566' class='stm mis'><a href='#n566'>566</a></p>
+<p id='n566' class='pln'><a href='#n566'>566</a></p>
 <p id='n567' class='pln'><a href='#n567'>567</a></p>
-<p id='n568' class='stm run hide_run'><a href='#n568'>568</a></p>
+<p id='n568' class='pln'><a href='#n568'>568</a></p>
 <p id='n569' class='pln'><a href='#n569'>569</a></p>
-<p id='n570' class='stm run hide_run'><a href='#n570'>570</a></p>
-<p id='n571' class='stm mis'><a href='#n571'>571</a></p>
-<p id='n572' class='stm mis'><a href='#n572'>572</a></p>
-<p id='n573' class='stm mis'><a href='#n573'>573</a></p>
-<p id='n574' class='stm mis'><a href='#n574'>574</a></p>
-<p id='n575' class='pln'><a href='#n575'>575</a></p>
-<p id='n576' class='stm mis'><a href='#n576'>576</a></p>
-<p id='n577' class='pln'><a href='#n577'>577</a></p>
-<p id='n578' class='stm mis'><a href='#n578'>578</a></p>
+<p id='n570' class='pln'><a href='#n570'>570</a></p>
+<p id='n571' class='pln'><a href='#n571'>571</a></p>
+<p id='n572' class='pln'><a href='#n572'>572</a></p>
+<p id='n573' class='stm run hide_run'><a href='#n573'>573</a></p>
+<p id='n574' class='pln'><a href='#n574'>574</a></p>
+<p id='n575' class='stm run hide_run'><a href='#n575'>575</a></p>
+<p id='n576' class='stm run hide_run'><a href='#n576'>576</a></p>
+<p id='n577' class='stm run hide_run'><a href='#n577'>577</a></p>
+<p id='n578' class='stm run hide_run'><a href='#n578'>578</a></p>
 <p id='n579' class='stm run hide_run'><a href='#n579'>579</a></p>
 <p id='n580' class='pln'><a href='#n580'>580</a></p>
 <p id='n581' class='stm run hide_run'><a href='#n581'>581</a></p>
 <p id='n582' class='pln'><a href='#n582'>582</a></p>
-<p id='n583' class='pln'><a href='#n583'>583</a></p>
+<p id='n583' class='stm run hide_run'><a href='#n583'>583</a></p>
 <p id='n584' class='pln'><a href='#n584'>584</a></p>
-<p id='n585' class='pln'><a href='#n585'>585</a></p>
-<p id='n586' class='pln'><a href='#n586'>586</a></p>
-<p id='n587' class='pln'><a href='#n587'>587</a></p>
-<p id='n588' class='pln'><a href='#n588'>588</a></p>
-<p id='n589' class='pln'><a href='#n589'>589</a></p>
+<p id='n585' class='stm run hide_run'><a href='#n585'>585</a></p>
+<p id='n586' class='stm run hide_run'><a href='#n586'>586</a></p>
+<p id='n587' class='stm run hide_run'><a href='#n587'>587</a></p>
+<p id='n588' class='stm run hide_run'><a href='#n588'>588</a></p>
+<p id='n589' class='stm run hide_run'><a href='#n589'>589</a></p>
 <p id='n590' class='pln'><a href='#n590'>590</a></p>
-<p id='n591' class='pln'><a href='#n591'>591</a></p>
+<p id='n591' class='stm mis'><a href='#n591'>591</a></p>
 <p id='n592' class='pln'><a href='#n592'>592</a></p>
-<p id='n593' class='pln'><a href='#n593'>593</a></p>
-<p id='n594' class='pln'><a href='#n594'>594</a></p>
+<p id='n593' class='stm run hide_run'><a href='#n593'>593</a></p>
+<p id='n594' class='stm run hide_run'><a href='#n594'>594</a></p>
 <p id='n595' class='pln'><a href='#n595'>595</a></p>
-<p id='n596' class='pln'><a href='#n596'>596</a></p>
+<p id='n596' class='stm run hide_run'><a href='#n596'>596</a></p>
 <p id='n597' class='pln'><a href='#n597'>597</a></p>
 <p id='n598' class='pln'><a href='#n598'>598</a></p>
-<p id='n599' class='stm mis'><a href='#n599'>599</a></p>
-<p id='n600' class='stm mis'><a href='#n600'>600</a></p>
-<p id='n601' class='stm mis'><a href='#n601'>601</a></p>
-<p id='n602' class='stm mis'><a href='#n602'>602</a></p>
-<p id='n603' class='stm mis'><a href='#n603'>603</a></p>
-<p id='n604' class='stm mis'><a href='#n604'>604</a></p>
+<p id='n599' class='pln'><a href='#n599'>599</a></p>
+<p id='n600' class='pln'><a href='#n600'>600</a></p>
+<p id='n601' class='pln'><a href='#n601'>601</a></p>
+<p id='n602' class='pln'><a href='#n602'>602</a></p>
+<p id='n603' class='pln'><a href='#n603'>603</a></p>
+<p id='n604' class='pln'><a href='#n604'>604</a></p>
 <p id='n605' class='pln'><a href='#n605'>605</a></p>
-<p id='n606' class='stm mis'><a href='#n606'>606</a></p>
-<p id='n607' class='stm mis'><a href='#n607'>607</a></p>
-<p id='n608' class='stm mis'><a href='#n608'>608</a></p>
-<p id='n609' class='stm mis'><a href='#n609'>609</a></p>
-<p id='n610' class='stm mis'><a href='#n610'>610</a></p>
+<p id='n606' class='pln'><a href='#n606'>606</a></p>
+<p id='n607' class='pln'><a href='#n607'>607</a></p>
+<p id='n608' class='pln'><a href='#n608'>608</a></p>
+<p id='n609' class='pln'><a href='#n609'>609</a></p>
+<p id='n610' class='pln'><a href='#n610'>610</a></p>
 <p id='n611' class='pln'><a href='#n611'>611</a></p>
-<p id='n612' class='stm mis'><a href='#n612'>612</a></p>
+<p id='n612' class='pln'><a href='#n612'>612</a></p>
 <p id='n613' class='pln'><a href='#n613'>613</a></p>
 <p id='n614' class='stm run hide_run'><a href='#n614'>614</a></p>
-<p id='n615' class='pln'><a href='#n615'>615</a></p>
-<p id='n616' class='stm mis'><a href='#n616'>616</a></p>
-<p id='n617' class='stm mis'><a href='#n617'>617</a></p>
-<p id='n618' class='stm mis'><a href='#n618'>618</a></p>
-<p id='n619' class='stm mis'><a href='#n619'>619</a></p>
-<p id='n620' class='stm mis'><a href='#n620'>620</a></p>
-<p id='n621' class='stm mis'><a href='#n621'>621</a></p>
-<p id='n622' class='stm mis'><a href='#n622'>622</a></p>
-<p id='n623' class='pln'><a href='#n623'>623</a></p>
-<p id='n624' class='stm mis'><a href='#n624'>624</a></p>
-<p id='n625' class='stm mis'><a href='#n625'>625</a></p>
-<p id='n626' class='stm mis'><a href='#n626'>626</a></p>
+<p id='n615' class='stm run hide_run'><a href='#n615'>615</a></p>
+<p id='n616' class='stm run hide_run'><a href='#n616'>616</a></p>
+<p id='n617' class='stm run hide_run'><a href='#n617'>617</a></p>
+<p id='n618' class='stm run hide_run'><a href='#n618'>618</a></p>
+<p id='n619' class='stm run hide_run'><a href='#n619'>619</a></p>
+<p id='n620' class='pln'><a href='#n620'>620</a></p>
+<p id='n621' class='stm run hide_run'><a href='#n621'>621</a></p>
+<p id='n622' class='stm run hide_run'><a href='#n622'>622</a></p>
+<p id='n623' class='stm run hide_run'><a href='#n623'>623</a></p>
+<p id='n624' class='stm run hide_run'><a href='#n624'>624</a></p>
+<p id='n625' class='stm run hide_run'><a href='#n625'>625</a></p>
+<p id='n626' class='stm run hide_run'><a href='#n626'>626</a></p>
 <p id='n627' class='stm mis'><a href='#n627'>627</a></p>
-<p id='n628' class='stm mis'><a href='#n628'>628</a></p>
+<p id='n628' class='pln'><a href='#n628'>628</a></p>
 <p id='n629' class='stm mis'><a href='#n629'>629</a></p>
-<p id='n630' class='stm mis'><a href='#n630'>630</a></p>
-<p id='n631' class='stm mis'><a href='#n631'>631</a></p>
-<p id='n632' class='stm mis'><a href='#n632'>632</a></p>
-<p id='n633' class='stm mis'><a href='#n633'>633</a></p>
-<p id='n634' class='stm mis'><a href='#n634'>634</a></p>
-<p id='n635' class='stm mis'><a href='#n635'>635</a></p>
-<p id='n636' class='stm mis'><a href='#n636'>636</a></p>
-<p id='n637' class='pln'><a href='#n637'>637</a></p>
+<p id='n630' class='pln'><a href='#n630'>630</a></p>
+<p id='n631' class='stm run hide_run'><a href='#n631'>631</a></p>
+<p id='n632' class='pln'><a href='#n632'>632</a></p>
+<p id='n633' class='stm run hide_run'><a href='#n633'>633</a></p>
+<p id='n634' class='stm run hide_run'><a href='#n634'>634</a></p>
+<p id='n635' class='stm run hide_run'><a href='#n635'>635</a></p>
+<p id='n636' class='stm run hide_run'><a href='#n636'>636</a></p>
+<p id='n637' class='stm run hide_run'><a href='#n637'>637</a></p>
 <p id='n638' class='stm run hide_run'><a href='#n638'>638</a></p>
-<p id='n639' class='pln'><a href='#n639'>639</a></p>
+<p id='n639' class='stm run hide_run'><a href='#n639'>639</a></p>
 <p id='n640' class='pln'><a href='#n640'>640</a></p>
-<p id='n641' class='pln'><a href='#n641'>641</a></p>
-<p id='n642' class='pln'><a href='#n642'>642</a></p>
-<p id='n643' class='pln'><a href='#n643'>643</a></p>
-<p id='n644' class='pln'><a href='#n644'>644</a></p>
-<p id='n645' class='pln'><a href='#n645'>645</a></p>
-<p id='n646' class='pln'><a href='#n646'>646</a></p>
+<p id='n641' class='stm run hide_run'><a href='#n641'>641</a></p>
+<p id='n642' class='stm run hide_run'><a href='#n642'>642</a></p>
+<p id='n643' class='stm run hide_run'><a href='#n643'>643</a></p>
+<p id='n644' class='stm mis'><a href='#n644'>644</a></p>
+<p id='n645' class='stm mis'><a href='#n645'>645</a></p>
+<p id='n646' class='stm run hide_run'><a href='#n646'>646</a></p>
 <p id='n647' class='stm run hide_run'><a href='#n647'>647</a></p>
 <p id='n648' class='stm run hide_run'><a href='#n648'>648</a></p>
 <p id='n649' class='stm run hide_run'><a href='#n649'>649</a></p>
 <p id='n650' class='stm run hide_run'><a href='#n650'>650</a></p>
 <p id='n651' class='stm run hide_run'><a href='#n651'>651</a></p>
-<p id='n652' class='stm mis'><a href='#n652'>652</a></p>
-<p id='n653' class='stm mis'><a href='#n653'>653</a></p>
+<p id='n652' class='stm run hide_run'><a href='#n652'>652</a></p>
+<p id='n653' class='stm run hide_run'><a href='#n653'>653</a></p>
 <p id='n654' class='pln'><a href='#n654'>654</a></p>
-<p id='n655' class='pln'><a href='#n655'>655</a></p>
+<p id='n655' class='stm run hide_run'><a href='#n655'>655</a></p>
 <p id='n656' class='pln'><a href='#n656'>656</a></p>
 <p id='n657' class='pln'><a href='#n657'>657</a></p>
 <p id='n658' class='pln'><a href='#n658'>658</a></p>
 <p id='n659' class='pln'><a href='#n659'>659</a></p>
-<p id='n660' class='stm run hide_run'><a href='#n660'>660</a></p>
-<p id='n661' class='stm run hide_run'><a href='#n661'>661</a></p>
-<p id='n662' class='stm run hide_run'><a href='#n662'>662</a></p>
-<p id='n663' class='stm run hide_run'><a href='#n663'>663</a></p>
-<p id='n664' class='stm mis'><a href='#n664'>664</a></p>
-<p id='n665' class='stm mis'><a href='#n665'>665</a></p>
-<p id='n666' class='stm mis'><a href='#n666'>666</a></p>
-<p id='n667' class='stm mis'><a href='#n667'>667</a></p>
+<p id='n660' class='pln'><a href='#n660'>660</a></p>
+<p id='n661' class='pln'><a href='#n661'>661</a></p>
+<p id='n662' class='pln'><a href='#n662'>662</a></p>
+<p id='n663' class='pln'><a href='#n663'>663</a></p>
+<p id='n664' class='stm run hide_run'><a href='#n664'>664</a></p>
+<p id='n665' class='stm run hide_run'><a href='#n665'>665</a></p>
+<p id='n666' class='stm run hide_run'><a href='#n666'>666</a></p>
+<p id='n667' class='stm run hide_run'><a href='#n667'>667</a></p>
 <p id='n668' class='stm run hide_run'><a href='#n668'>668</a></p>
-<p id='n669' class='stm run hide_run'><a href='#n669'>669</a></p>
-<p id='n670' class='stm run hide_run'><a href='#n670'>670</a></p>
-<p id='n671' class='stm run hide_run'><a href='#n671'>671</a></p>
-<p id='n672' class='stm run hide_run'><a href='#n672'>672</a></p>
-<p id='n673' class='stm run hide_run'><a href='#n673'>673</a></p>
-<p id='n674' class='stm run hide_run'><a href='#n674'>674</a></p>
-<p id='n675' class='stm run hide_run'><a href='#n675'>675</a></p>
-<p id='n676' class='stm mis'><a href='#n676'>676</a></p>
-<p id='n677' class='stm mis'><a href='#n677'>677</a></p>
+<p id='n669' class='stm mis'><a href='#n669'>669</a></p>
+<p id='n670' class='stm mis'><a href='#n670'>670</a></p>
+<p id='n671' class='pln'><a href='#n671'>671</a></p>
+<p id='n672' class='pln'><a href='#n672'>672</a></p>
+<p id='n673' class='pln'><a href='#n673'>673</a></p>
+<p id='n674' class='pln'><a href='#n674'>674</a></p>
+<p id='n675' class='pln'><a href='#n675'>675</a></p>
+<p id='n676' class='pln'><a href='#n676'>676</a></p>
+<p id='n677' class='stm run hide_run'><a href='#n677'>677</a></p>
 <p id='n678' class='stm run hide_run'><a href='#n678'>678</a></p>
-<p id='n679' class='pln'><a href='#n679'>679</a></p>
-<p id='n680' class='pln'><a href='#n680'>680</a></p>
-<p id='n681' class='pln'><a href='#n681'>681</a></p>
-<p id='n682' class='pln'><a href='#n682'>682</a></p>
-<p id='n683' class='pln'><a href='#n683'>683</a></p>
-<p id='n684' class='pln'><a href='#n684'>684</a></p>
+<p id='n679' class='stm run hide_run'><a href='#n679'>679</a></p>
+<p id='n680' class='stm run hide_run'><a href='#n680'>680</a></p>
+<p id='n681' class='stm mis'><a href='#n681'>681</a></p>
+<p id='n682' class='stm mis'><a href='#n682'>682</a></p>
+<p id='n683' class='stm mis'><a href='#n683'>683</a></p>
+<p id='n684' class='stm mis'><a href='#n684'>684</a></p>
 <p id='n685' class='stm run hide_run'><a href='#n685'>685</a></p>
 <p id='n686' class='stm run hide_run'><a href='#n686'>686</a></p>
-<p id='n687' class='pln'><a href='#n687'>687</a></p>
+<p id='n687' class='stm run hide_run'><a href='#n687'>687</a></p>
 <p id='n688' class='stm run hide_run'><a href='#n688'>688</a></p>
-<p id='n689' class='stm mis'><a href='#n689'>689</a></p>
-<p id='n690' class='stm mis'><a href='#n690'>690</a></p>
-<p id='n691' class='stm mis'><a href='#n691'>691</a></p>
-<p id='n692' class='stm mis'><a href='#n692'>692</a></p>
+<p id='n689' class='stm run hide_run'><a href='#n689'>689</a></p>
+<p id='n690' class='stm run hide_run'><a href='#n690'>690</a></p>
+<p id='n691' class='stm run hide_run'><a href='#n691'>691</a></p>
+<p id='n692' class='stm run hide_run'><a href='#n692'>692</a></p>
 <p id='n693' class='stm mis'><a href='#n693'>693</a></p>
-<p id='n694' class='pln'><a href='#n694'>694</a></p>
-<p id='n695' class='pln'><a href='#n695'>695</a></p>
+<p id='n694' class='stm mis'><a href='#n694'>694</a></p>
+<p id='n695' class='stm run hide_run'><a href='#n695'>695</a></p>
 <p id='n696' class='pln'><a href='#n696'>696</a></p>
 <p id='n697' class='pln'><a href='#n697'>697</a></p>
 <p id='n698' class='pln'><a href='#n698'>698</a></p>
 <p id='n699' class='pln'><a href='#n699'>699</a></p>
-<p id='n700' class='stm run hide_run'><a href='#n700'>700</a></p>
-<p id='n701' class='stm run hide_run'><a href='#n701'>701</a></p>
+<p id='n700' class='pln'><a href='#n700'>700</a></p>
+<p id='n701' class='pln'><a href='#n701'>701</a></p>
 <p id='n702' class='stm run hide_run'><a href='#n702'>702</a></p>
-<p id='n703' class='stm mis'><a href='#n703'>703</a></p>
-<p id='n704' class='stm mis'><a href='#n704'>704</a></p>
-<p id='n705' class='stm mis'><a href='#n705'>705</a></p>
-<p id='n706' class='stm mis'><a href='#n706'>706</a></p>
+<p id='n703' class='stm run hide_run'><a href='#n703'>703</a></p>
+<p id='n704' class='pln'><a href='#n704'>704</a></p>
+<p id='n705' class='stm run hide_run'><a href='#n705'>705</a></p>
+<p id='n706' class='stm run hide_run'><a href='#n706'>706</a></p>
 <p id='n707' class='stm run hide_run'><a href='#n707'>707</a></p>
-<p id='n708' class='pln'><a href='#n708'>708</a></p>
-<p id='n709' class='stm run hide_run'><a href='#n709'>709</a></p>
-<p id='n710' class='pln'><a href='#n710'>710</a></p>
+<p id='n708' class='stm mis'><a href='#n708'>708</a></p>
+<p id='n709' class='stm mis'><a href='#n709'>709</a></p>
+<p id='n710' class='stm run hide_run'><a href='#n710'>710</a></p>
 <p id='n711' class='pln'><a href='#n711'>711</a></p>
 <p id='n712' class='pln'><a href='#n712'>712</a></p>
 <p id='n713' class='pln'><a href='#n713'>713</a></p>
 <p id='n714' class='pln'><a href='#n714'>714</a></p>
 <p id='n715' class='pln'><a href='#n715'>715</a></p>
 <p id='n716' class='pln'><a href='#n716'>716</a></p>
-<p id='n717' class='pln'><a href='#n717'>717</a></p>
-<p id='n718' class='pln'><a href='#n718'>718</a></p>
-<p id='n719' class='pln'><a href='#n719'>719</a></p>
-<p id='n720' class='pln'><a href='#n720'>720</a></p>
+<p id='n717' class='stm run hide_run'><a href='#n717'>717</a></p>
+<p id='n718' class='stm run hide_run'><a href='#n718'>718</a></p>
+<p id='n719' class='stm run hide_run'><a href='#n719'>719</a></p>
+<p id='n720' class='stm run hide_run'><a href='#n720'>720</a></p>
 <p id='n721' class='stm run hide_run'><a href='#n721'>721</a></p>
 <p id='n722' class='stm run hide_run'><a href='#n722'>722</a></p>
 <p id='n723' class='stm run hide_run'><a href='#n723'>723</a></p>
-<p id='n724' class='stm mis'><a href='#n724'>724</a></p>
-<p id='n725' class='stm mis'><a href='#n725'>725</a></p>
-<p id='n726' class='stm mis'><a href='#n726'>726</a></p>
-<p id='n727' class='stm run hide_run'><a href='#n727'>727</a></p>
-<p id='n728' class='stm run hide_run'><a href='#n728'>728</a></p>
-<p id='n729' class='stm run hide_run'><a href='#n729'>729</a></p>
-<p id='n730' class='stm run hide_run'><a href='#n730'>730</a></p>
-<p id='n731' class='stm run hide_run'><a href='#n731'>731</a></p>
-<p id='n732' class='stm mis'><a href='#n732'>732</a></p>
-<p id='n733' class='stm mis'><a href='#n733'>733</a></p>
-<p id='n734' class='stm mis'><a href='#n734'>734</a></p>
-<p id='n735' class='stm mis'><a href='#n735'>735</a></p>
+<p id='n724' class='stm run hide_run'><a href='#n724'>724</a></p>
+<p id='n725' class='pln'><a href='#n725'>725</a></p>
+<p id='n726' class='stm run hide_run'><a href='#n726'>726</a></p>
+<p id='n727' class='pln'><a href='#n727'>727</a></p>
+<p id='n728' class='pln'><a href='#n728'>728</a></p>
+<p id='n729' class='pln'><a href='#n729'>729</a></p>
+<p id='n730' class='pln'><a href='#n730'>730</a></p>
+<p id='n731' class='pln'><a href='#n731'>731</a></p>
+<p id='n732' class='pln'><a href='#n732'>732</a></p>
+<p id='n733' class='pln'><a href='#n733'>733</a></p>
+<p id='n734' class='pln'><a href='#n734'>734</a></p>
+<p id='n735' class='pln'><a href='#n735'>735</a></p>
 <p id='n736' class='pln'><a href='#n736'>736</a></p>
-<p id='n737' class='stm run hide_run'><a href='#n737'>737</a></p>
+<p id='n737' class='pln'><a href='#n737'>737</a></p>
 <p id='n738' class='stm run hide_run'><a href='#n738'>738</a></p>
-<p id='n739' class='stm mis'><a href='#n739'>739</a></p>
+<p id='n739' class='stm run hide_run'><a href='#n739'>739</a></p>
 <p id='n740' class='stm run hide_run'><a href='#n740'>740</a></p>
-<p id='n741' class='stm mis'><a href='#n741'>741</a></p>
-<p id='n742' class='stm mis'><a href='#n742'>742</a></p>
-<p id='n743' class='stm mis'><a href='#n743'>743</a></p>
-<p id='n744' class='stm mis'><a href='#n744'>744</a></p>
-<p id='n745' class='stm mis'><a href='#n745'>745</a></p>
-<p id='n746' class='pln'><a href='#n746'>746</a></p>
-<p id='n747' class='pln'><a href='#n747'>747</a></p>
-<p id='n748' class='pln'><a href='#n748'>748</a></p>
-<p id='n749' class='pln'><a href='#n749'>749</a></p>
-<p id='n750' class='pln'><a href='#n750'>750</a></p>
-<p id='n751' class='pln'><a href='#n751'>751</a></p>
+<p id='n741' class='stm run hide_run'><a href='#n741'>741</a></p>
+<p id='n742' class='stm run hide_run'><a href='#n742'>742</a></p>
+<p id='n743' class='stm run hide_run'><a href='#n743'>743</a></p>
+<p id='n744' class='stm run hide_run'><a href='#n744'>744</a></p>
+<p id='n745' class='stm run hide_run'><a href='#n745'>745</a></p>
+<p id='n746' class='stm run hide_run'><a href='#n746'>746</a></p>
+<p id='n747' class='stm run hide_run'><a href='#n747'>747</a></p>
+<p id='n748' class='stm run hide_run'><a href='#n748'>748</a></p>
+<p id='n749' class='stm run hide_run'><a href='#n749'>749</a></p>
+<p id='n750' class='stm run hide_run'><a href='#n750'>750</a></p>
+<p id='n751' class='stm run hide_run'><a href='#n751'>751</a></p>
 <p id='n752' class='stm run hide_run'><a href='#n752'>752</a></p>
-<p id='n753' class='stm run hide_run'><a href='#n753'>753</a></p>
+<p id='n753' class='pln'><a href='#n753'>753</a></p>
 <p id='n754' class='stm run hide_run'><a href='#n754'>754</a></p>
-<p id='n755' class='stm mis'><a href='#n755'>755</a></p>
+<p id='n755' class='stm run hide_run'><a href='#n755'>755</a></p>
 <p id='n756' class='stm mis'><a href='#n756'>756</a></p>
-<p id='n757' class='stm mis'><a href='#n757'>757</a></p>
+<p id='n757' class='stm run hide_run'><a href='#n757'>757</a></p>
 <p id='n758' class='stm mis'><a href='#n758'>758</a></p>
 <p id='n759' class='stm mis'><a href='#n759'>759</a></p>
-<p id='n760' class='pln'><a href='#n760'>760</a></p>
+<p id='n760' class='stm mis'><a href='#n760'>760</a></p>
 <p id='n761' class='stm mis'><a href='#n761'>761</a></p>
 <p id='n762' class='stm mis'><a href='#n762'>762</a></p>
-<p id='n763' class='stm mis'><a href='#n763'>763</a></p>
+<p id='n763' class='pln'><a href='#n763'>763</a></p>
 <p id='n764' class='pln'><a href='#n764'>764</a></p>
-<p id='n765' class='stm run hide_run'><a href='#n765'>765</a></p>
+<p id='n765' class='pln'><a href='#n765'>765</a></p>
 <p id='n766' class='pln'><a href='#n766'>766</a></p>
-<p id='n767' class='stm run hide_run'><a href='#n767'>767</a></p>
+<p id='n767' class='pln'><a href='#n767'>767</a></p>
 <p id='n768' class='pln'><a href='#n768'>768</a></p>
-<p id='n769' class='pln'><a href='#n769'>769</a></p>
-<p id='n770' class='pln'><a href='#n770'>770</a></p>
+<p id='n769' class='stm run hide_run'><a href='#n769'>769</a></p>
+<p id='n770' class='stm run hide_run'><a href='#n770'>770</a></p>
 <p id='n771' class='stm run hide_run'><a href='#n771'>771</a></p>
-<p id='n772' class='pln'><a href='#n772'>772</a></p>
-<p id='n773' class='pln'><a href='#n773'>773</a></p>
-<p id='n774' class='pln'><a href='#n774'>774</a></p>
-<p id='n775' class='pln'><a href='#n775'>775</a></p>
-<p id='n776' class='pln'><a href='#n776'>776</a></p>
+<p id='n772' class='stm run hide_run'><a href='#n772'>772</a></p>
+<p id='n773' class='stm run hide_run'><a href='#n773'>773</a></p>
+<p id='n774' class='stm run hide_run'><a href='#n774'>774</a></p>
+<p id='n775' class='stm run hide_run'><a href='#n775'>775</a></p>
+<p id='n776' class='stm run hide_run'><a href='#n776'>776</a></p>
 <p id='n777' class='pln'><a href='#n777'>777</a></p>
-<p id='n778' class='pln'><a href='#n778'>778</a></p>
-<p id='n779' class='pln'><a href='#n779'>779</a></p>
-<p id='n780' class='pln'><a href='#n780'>780</a></p>
+<p id='n778' class='stm run hide_run'><a href='#n778'>778</a></p>
+<p id='n779' class='stm run hide_run'><a href='#n779'>779</a></p>
+<p id='n780' class='stm run hide_run'><a href='#n780'>780</a></p>
 <p id='n781' class='pln'><a href='#n781'>781</a></p>
-<p id='n782' class='pln'><a href='#n782'>782</a></p>
+<p id='n782' class='stm run hide_run'><a href='#n782'>782</a></p>
 <p id='n783' class='pln'><a href='#n783'>783</a></p>
-<p id='n784' class='pln'><a href='#n784'>784</a></p>
+<p id='n784' class='stm run hide_run'><a href='#n784'>784</a></p>
 <p id='n785' class='pln'><a href='#n785'>785</a></p>
-<p id='n786' class='stm mis'><a href='#n786'>786</a></p>
-<p id='n787' class='stm mis'><a href='#n787'>787</a></p>
-<p id='n788' class='stm mis'><a href='#n788'>788</a></p>
-<p id='n789' class='stm mis'><a href='#n789'>789</a></p>
-<p id='n790' class='stm mis'><a href='#n790'>790</a></p>
-<p id='n791' class='stm mis'><a href='#n791'>791</a></p>
-<p id='n792' class='stm mis'><a href='#n792'>792</a></p>
-<p id='n793' class='stm mis'><a href='#n793'>793</a></p>
-<p id='n794' class='stm mis'><a href='#n794'>794</a></p>
+<p id='n786' class='pln'><a href='#n786'>786</a></p>
+<p id='n787' class='pln'><a href='#n787'>787</a></p>
+<p id='n788' class='stm run hide_run'><a href='#n788'>788</a></p>
+<p id='n789' class='pln'><a href='#n789'>789</a></p>
+<p id='n790' class='pln'><a href='#n790'>790</a></p>
+<p id='n791' class='pln'><a href='#n791'>791</a></p>
+<p id='n792' class='pln'><a href='#n792'>792</a></p>
+<p id='n793' class='pln'><a href='#n793'>793</a></p>
+<p id='n794' class='pln'><a href='#n794'>794</a></p>
 <p id='n795' class='pln'><a href='#n795'>795</a></p>
 <p id='n796' class='pln'><a href='#n796'>796</a></p>
 <p id='n797' class='pln'><a href='#n797'>797</a></p>
-<p id='n798' class='stm mis'><a href='#n798'>798</a></p>
-<p id='n799' class='stm mis'><a href='#n799'>799</a></p>
+<p id='n798' class='pln'><a href='#n798'>798</a></p>
+<p id='n799' class='pln'><a href='#n799'>799</a></p>
 <p id='n800' class='pln'><a href='#n800'>800</a></p>
 <p id='n801' class='pln'><a href='#n801'>801</a></p>
 <p id='n802' class='pln'><a href='#n802'>802</a></p>
-<p id='n803' class='pln'><a href='#n803'>803</a></p>
-<p id='n804' class='stm mis'><a href='#n804'>804</a></p>
+<p id='n803' class='stm run hide_run'><a href='#n803'>803</a></p>
+<p id='n804' class='stm run hide_run'><a href='#n804'>804</a></p>
 <p id='n805' class='stm mis'><a href='#n805'>805</a></p>
-<p id='n806' class='stm mis'><a href='#n806'>806</a></p>
-<p id='n807' class='stm mis'><a href='#n807'>807</a></p>
-<p id='n808' class='stm mis'><a href='#n808'>808</a></p>
-<p id='n809' class='pln'><a href='#n809'>809</a></p>
-<p id='n810' class='stm mis'><a href='#n810'>810</a></p>
-<p id='n811' class='stm mis'><a href='#n811'>811</a></p>
-<p id='n812' class='stm mis'><a href='#n812'>812</a></p>
-<p id='n813' class='stm mis'><a href='#n813'>813</a></p>
-<p id='n814' class='stm mis'><a href='#n814'>814</a></p>
-<p id='n815' class='stm mis'><a href='#n815'>815</a></p>
-<p id='n816' class='stm mis'><a href='#n816'>816</a></p>
-<p id='n817' class='stm mis'><a href='#n817'>817</a></p>
+<p id='n806' class='stm run hide_run'><a href='#n806'>806</a></p>
+<p id='n807' class='stm run hide_run'><a href='#n807'>807</a></p>
+<p id='n808' class='stm run hide_run'><a href='#n808'>808</a></p>
+<p id='n809' class='stm run hide_run'><a href='#n809'>809</a></p>
+<p id='n810' class='stm run hide_run'><a href='#n810'>810</a></p>
+<p id='n811' class='stm run hide_run'><a href='#n811'>811</a></p>
+<p id='n812' class='pln'><a href='#n812'>812</a></p>
+<p id='n813' class='pln'><a href='#n813'>813</a></p>
+<p id='n814' class='pln'><a href='#n814'>814</a></p>
+<p id='n815' class='stm run hide_run'><a href='#n815'>815</a></p>
+<p id='n816' class='stm run hide_run'><a href='#n816'>816</a></p>
+<p id='n817' class='pln'><a href='#n817'>817</a></p>
 <p id='n818' class='pln'><a href='#n818'>818</a></p>
-<p id='n819' class='stm run hide_run'><a href='#n819'>819</a></p>
-<p id='n820' class='stm mis'><a href='#n820'>820</a></p>
-<p id='n821' class='stm mis'><a href='#n821'>821</a></p>
-<p id='n822' class='stm mis'><a href='#n822'>822</a></p>
-<p id='n823' class='stm mis'><a href='#n823'>823</a></p>
-<p id='n824' class='stm mis'><a href='#n824'>824</a></p>
-<p id='n825' class='pln'><a href='#n825'>825</a></p>
+<p id='n819' class='pln'><a href='#n819'>819</a></p>
+<p id='n820' class='pln'><a href='#n820'>820</a></p>
+<p id='n821' class='stm run hide_run'><a href='#n821'>821</a></p>
+<p id='n822' class='stm run hide_run'><a href='#n822'>822</a></p>
+<p id='n823' class='stm run hide_run'><a href='#n823'>823</a></p>
+<p id='n824' class='stm run hide_run'><a href='#n824'>824</a></p>
+<p id='n825' class='stm mis'><a href='#n825'>825</a></p>
 <p id='n826' class='pln'><a href='#n826'>826</a></p>
-<p id='n827' class='stm mis'><a href='#n827'>827</a></p>
-<p id='n828' class='stm mis'><a href='#n828'>828</a></p>
-<p id='n829' class='stm mis'><a href='#n829'>829</a></p>
-<p id='n830' class='stm mis'><a href='#n830'>830</a></p>
-<p id='n831' class='pln'><a href='#n831'>831</a></p>
-<p id='n832' class='stm mis'><a href='#n832'>832</a></p>
-<p id='n833' class='stm mis'><a href='#n833'>833</a></p>
-<p id='n834' class='stm mis'><a href='#n834'>834</a></p>
-<p id='n835' class='stm mis'><a href='#n835'>835</a></p>
-<p id='n836' class='stm mis'><a href='#n836'>836</a></p>
-<p id='n837' class='pln'><a href='#n837'>837</a></p>
-<p id='n838' class='stm mis'><a href='#n838'>838</a></p>
-<p id='n839' class='stm mis'><a href='#n839'>839</a></p>
+<p id='n827' class='stm run hide_run'><a href='#n827'>827</a></p>
+<p id='n828' class='stm run hide_run'><a href='#n828'>828</a></p>
+<p id='n829' class='stm run hide_run'><a href='#n829'>829</a></p>
+<p id='n830' class='stm run hide_run'><a href='#n830'>830</a></p>
+<p id='n831' class='stm run hide_run'><a href='#n831'>831</a></p>
+<p id='n832' class='stm run hide_run'><a href='#n832'>832</a></p>
+<p id='n833' class='stm run hide_run'><a href='#n833'>833</a></p>
+<p id='n834' class='stm run hide_run'><a href='#n834'>834</a></p>
+<p id='n835' class='pln'><a href='#n835'>835</a></p>
+<p id='n836' class='stm run hide_run'><a href='#n836'>836</a></p>
+<p id='n837' class='stm run hide_run'><a href='#n837'>837</a></p>
+<p id='n838' class='stm run hide_run'><a href='#n838'>838</a></p>
+<p id='n839' class='stm run hide_run'><a href='#n839'>839</a></p>
 <p id='n840' class='stm mis'><a href='#n840'>840</a></p>
 <p id='n841' class='stm mis'><a href='#n841'>841</a></p>
 <p id='n842' class='pln'><a href='#n842'>842</a></p>
-<p id='n843' class='stm mis'><a href='#n843'>843</a></p>
+<p id='n843' class='pln'><a href='#n843'>843</a></p>
 <p id='n844' class='stm mis'><a href='#n844'>844</a></p>
-<p id='n845' class='pln'><a href='#n845'>845</a></p>
-<p id='n846' class='pln'><a href='#n846'>846</a></p>
+<p id='n845' class='stm mis'><a href='#n845'>845</a></p>
+<p id='n846' class='stm run hide_run'><a href='#n846'>846</a></p>
 <p id='n847' class='stm run hide_run'><a href='#n847'>847</a></p>
 <p id='n848' class='pln'><a href='#n848'>848</a></p>
-<p id='n849' class='pln'><a href='#n849'>849</a></p>
-<p id='n850' class='pln'><a href='#n850'>850</a></p>
-<p id='n851' class='pln'><a href='#n851'>851</a></p>
-<p id='n852' class='pln'><a href='#n852'>852</a></p>
-<p id='n853' class='pln'><a href='#n853'>853</a></p>
+<p id='n849' class='stm run hide_run'><a href='#n849'>849</a></p>
+<p id='n850' class='stm run hide_run'><a href='#n850'>850</a></p>
+<p id='n851' class='stm run hide_run'><a href='#n851'>851</a></p>
+<p id='n852' class='stm run hide_run'><a href='#n852'>852</a></p>
+<p id='n853' class='stm run hide_run'><a href='#n853'>853</a></p>
 <p id='n854' class='pln'><a href='#n854'>854</a></p>
-<p id='n855' class='pln'><a href='#n855'>855</a></p>
-<p id='n856' class='pln'><a href='#n856'>856</a></p>
-<p id='n857' class='stm run hide_run'><a href='#n857'>857</a></p>
-<p id='n858' class='stm run hide_run'><a href='#n858'>858</a></p>
-<p id='n859' class='stm run hide_run'><a href='#n859'>859</a></p>
-<p id='n860' class='stm run hide_run'><a href='#n860'>860</a></p>
+<p id='n855' class='stm run hide_run'><a href='#n855'>855</a></p>
+<p id='n856' class='stm run hide_run'><a href='#n856'>856</a></p>
+<p id='n857' class='stm mis'><a href='#n857'>857</a></p>
+<p id='n858' class='stm mis'><a href='#n858'>858</a></p>
+<p id='n859' class='pln'><a href='#n859'>859</a></p>
+<p id='n860' class='stm mis'><a href='#n860'>860</a></p>
 <p id='n861' class='stm run hide_run'><a href='#n861'>861</a></p>
-<p id='n862' class='stm run hide_run'><a href='#n862'>862</a></p>
-<p id='n863' class='stm run hide_run'><a href='#n863'>863</a></p>
+<p id='n862' class='pln'><a href='#n862'>862</a></p>
+<p id='n863' class='pln'><a href='#n863'>863</a></p>
 <p id='n864' class='stm run hide_run'><a href='#n864'>864</a></p>
-<p id='n865' class='stm run hide_run'><a href='#n865'>865</a></p>
-<p id='n866' class='stm run hide_run'><a href='#n866'>866</a></p>
-<p id='n867' class='stm run hide_run'><a href='#n867'>867</a></p>
-<p id='n868' class='stm run hide_run'><a href='#n868'>868</a></p>
-<p id='n869' class='stm run hide_run'><a href='#n869'>869</a></p>
-<p id='n870' class='stm run hide_run'><a href='#n870'>870</a></p>
-<p id='n871' class='stm run hide_run'><a href='#n871'>871</a></p>
-<p id='n872' class='stm run hide_run'><a href='#n872'>872</a></p>
-<p id='n873' class='stm run hide_run'><a href='#n873'>873</a></p>
-<p id='n874' class='pln'><a href='#n874'>874</a></p>
-<p id='n875' class='pln'><a href='#n875'>875</a></p>
+<p id='n865' class='pln'><a href='#n865'>865</a></p>
+<p id='n866' class='pln'><a href='#n866'>866</a></p>
+<p id='n867' class='pln'><a href='#n867'>867</a></p>
+<p id='n868' class='pln'><a href='#n868'>868</a></p>
+<p id='n869' class='pln'><a href='#n869'>869</a></p>
+<p id='n870' class='pln'><a href='#n870'>870</a></p>
+<p id='n871' class='pln'><a href='#n871'>871</a></p>
+<p id='n872' class='pln'><a href='#n872'>872</a></p>
+<p id='n873' class='pln'><a href='#n873'>873</a></p>
+<p id='n874' class='stm run hide_run'><a href='#n874'>874</a></p>
+<p id='n875' class='stm run hide_run'><a href='#n875'>875</a></p>
 <p id='n876' class='stm run hide_run'><a href='#n876'>876</a></p>
-<p id='n877' class='pln'><a href='#n877'>877</a></p>
-<p id='n878' class='pln'><a href='#n878'>878</a></p>
-<p id='n879' class='pln'><a href='#n879'>879</a></p>
-<p id='n880' class='pln'><a href='#n880'>880</a></p>
-<p id='n881' class='pln'><a href='#n881'>881</a></p>
-<p id='n882' class='pln'><a href='#n882'>882</a></p>
-<p id='n883' class='pln'><a href='#n883'>883</a></p>
-<p id='n884' class='pln'><a href='#n884'>884</a></p>
-<p id='n885' class='pln'><a href='#n885'>885</a></p>
-<p id='n886' class='pln'><a href='#n886'>886</a></p>
+<p id='n877' class='stm run hide_run'><a href='#n877'>877</a></p>
+<p id='n878' class='stm run hide_run'><a href='#n878'>878</a></p>
+<p id='n879' class='stm run hide_run'><a href='#n879'>879</a></p>
+<p id='n880' class='stm run hide_run'><a href='#n880'>880</a></p>
+<p id='n881' class='stm run hide_run'><a href='#n881'>881</a></p>
+<p id='n882' class='stm run hide_run'><a href='#n882'>882</a></p>
+<p id='n883' class='stm run hide_run'><a href='#n883'>883</a></p>
+<p id='n884' class='stm run hide_run'><a href='#n884'>884</a></p>
+<p id='n885' class='stm run hide_run'><a href='#n885'>885</a></p>
+<p id='n886' class='stm run hide_run'><a href='#n886'>886</a></p>
 <p id='n887' class='stm run hide_run'><a href='#n887'>887</a></p>
-<p id='n888' class='pln'><a href='#n888'>888</a></p>
-<p id='n889' class='pln'><a href='#n889'>889</a></p>
-<p id='n890' class='pln'><a href='#n890'>890</a></p>
+<p id='n888' class='stm run hide_run'><a href='#n888'>888</a></p>
+<p id='n889' class='stm run hide_run'><a href='#n889'>889</a></p>
+<p id='n890' class='stm run hide_run'><a href='#n890'>890</a></p>
 <p id='n891' class='pln'><a href='#n891'>891</a></p>
 <p id='n892' class='pln'><a href='#n892'>892</a></p>
-<p id='n893' class='pln'><a href='#n893'>893</a></p>
+<p id='n893' class='stm run hide_run'><a href='#n893'>893</a></p>
 <p id='n894' class='pln'><a href='#n894'>894</a></p>
-<p id='n895' class='stm run hide_run'><a href='#n895'>895</a></p>
-<p id='n896' class='stm run hide_run'><a href='#n896'>896</a></p>
-<p id='n897' class='stm run hide_run'><a href='#n897'>897</a></p>
-<p id='n898' class='stm run hide_run'><a href='#n898'>898</a></p>
-<p id='n899' class='stm run hide_run'><a href='#n899'>899</a></p>
-<p id='n900' class='stm run hide_run'><a href='#n900'>900</a></p>
-<p id='n901' class='stm run hide_run'><a href='#n901'>901</a></p>
-<p id='n902' class='stm run hide_run'><a href='#n902'>902</a></p>
-<p id='n903' class='stm run hide_run'><a href='#n903'>903</a></p>
+<p id='n895' class='pln'><a href='#n895'>895</a></p>
+<p id='n896' class='pln'><a href='#n896'>896</a></p>
+<p id='n897' class='pln'><a href='#n897'>897</a></p>
+<p id='n898' class='pln'><a href='#n898'>898</a></p>
+<p id='n899' class='pln'><a href='#n899'>899</a></p>
+<p id='n900' class='pln'><a href='#n900'>900</a></p>
+<p id='n901' class='pln'><a href='#n901'>901</a></p>
+<p id='n902' class='pln'><a href='#n902'>902</a></p>
+<p id='n903' class='pln'><a href='#n903'>903</a></p>
 <p id='n904' class='stm run hide_run'><a href='#n904'>904</a></p>
 <p id='n905' class='pln'><a href='#n905'>905</a></p>
 <p id='n906' class='pln'><a href='#n906'>906</a></p>
 <p id='n907' class='pln'><a href='#n907'>907</a></p>
-<p id='n908' class='stm run hide_run'><a href='#n908'>908</a></p>
-<p id='n909' class='stm run hide_run'><a href='#n909'>909</a></p>
-<p id='n910' class='stm run hide_run'><a href='#n910'>910</a></p>
-<p id='n911' class='stm run hide_run'><a href='#n911'>911</a></p>
+<p id='n908' class='pln'><a href='#n908'>908</a></p>
+<p id='n909' class='pln'><a href='#n909'>909</a></p>
+<p id='n910' class='pln'><a href='#n910'>910</a></p>
+<p id='n911' class='pln'><a href='#n911'>911</a></p>
 <p id='n912' class='stm run hide_run'><a href='#n912'>912</a></p>
 <p id='n913' class='stm run hide_run'><a href='#n913'>913</a></p>
-<p id='n914' class='pln'><a href='#n914'>914</a></p>
-<p id='n915' class='pln'><a href='#n915'>915</a></p>
-<p id='n916' class='pln'><a href='#n916'>916</a></p>
-<p id='n917' class='pln'><a href='#n917'>917</a></p>
-<p id='n918' class='pln'><a href='#n918'>918</a></p>
+<p id='n914' class='stm run hide_run'><a href='#n914'>914</a></p>
+<p id='n915' class='stm run hide_run'><a href='#n915'>915</a></p>
+<p id='n916' class='stm run hide_run'><a href='#n916'>916</a></p>
+<p id='n917' class='stm run hide_run'><a href='#n917'>917</a></p>
+<p id='n918' class='stm run hide_run'><a href='#n918'>918</a></p>
 <p id='n919' class='stm run hide_run'><a href='#n919'>919</a></p>
-<p id='n920' class='pln'><a href='#n920'>920</a></p>
-<p id='n921' class='pln'><a href='#n921'>921</a></p>
-<p id='n922' class='stm run hide_run'><a href='#n922'>922</a></p>
+<p id='n920' class='stm run hide_run'><a href='#n920'>920</a></p>
+<p id='n921' class='stm run hide_run'><a href='#n921'>921</a></p>
+<p id='n922' class='pln'><a href='#n922'>922</a></p>
 <p id='n923' class='pln'><a href='#n923'>923</a></p>
 <p id='n924' class='pln'><a href='#n924'>924</a></p>
-<p id='n925' class='pln'><a href='#n925'>925</a></p>
-<p id='n926' class='pln'><a href='#n926'>926</a></p>
-<p id='n927' class='pln'><a href='#n927'>927</a></p>
-<p id='n928' class='pln'><a href='#n928'>928</a></p>
-<p id='n929' class='pln'><a href='#n929'>929</a></p>
-<p id='n930' class='pln'><a href='#n930'>930</a></p>
+<p id='n925' class='stm run hide_run'><a href='#n925'>925</a></p>
+<p id='n926' class='stm run hide_run'><a href='#n926'>926</a></p>
+<p id='n927' class='stm run hide_run'><a href='#n927'>927</a></p>
+<p id='n928' class='stm run hide_run'><a href='#n928'>928</a></p>
+<p id='n929' class='stm run hide_run'><a href='#n929'>929</a></p>
+<p id='n930' class='stm run hide_run'><a href='#n930'>930</a></p>
 <p id='n931' class='pln'><a href='#n931'>931</a></p>
 <p id='n932' class='pln'><a href='#n932'>932</a></p>
 <p id='n933' class='pln'><a href='#n933'>933</a></p>
 <p id='n934' class='pln'><a href='#n934'>934</a></p>
 <p id='n935' class='pln'><a href='#n935'>935</a></p>
-<p id='n936' class='pln'><a href='#n936'>936</a></p>
+<p id='n936' class='stm run hide_run'><a href='#n936'>936</a></p>
 <p id='n937' class='pln'><a href='#n937'>937</a></p>
 <p id='n938' class='pln'><a href='#n938'>938</a></p>
 <p id='n939' class='stm run hide_run'><a href='#n939'>939</a></p>
@@ -1007,53 +1007,53 @@ <h2 class='stats'>
 <p id='n944' class='pln'><a href='#n944'>944</a></p>
 <p id='n945' class='pln'><a href='#n945'>945</a></p>
 <p id='n946' class='pln'><a href='#n946'>946</a></p>
-<p id='n947' class='stm run hide_run'><a href='#n947'>947</a></p>
-<p id='n948' class='stm run hide_run'><a href='#n948'>948</a></p>
-<p id='n949' class='stm run hide_run'><a href='#n949'>949</a></p>
-<p id='n950' class='stm run hide_run'><a href='#n950'>950</a></p>
+<p id='n947' class='pln'><a href='#n947'>947</a></p>
+<p id='n948' class='pln'><a href='#n948'>948</a></p>
+<p id='n949' class='pln'><a href='#n949'>949</a></p>
+<p id='n950' class='pln'><a href='#n950'>950</a></p>
 <p id='n951' class='pln'><a href='#n951'>951</a></p>
 <p id='n952' class='pln'><a href='#n952'>952</a></p>
 <p id='n953' class='pln'><a href='#n953'>953</a></p>
 <p id='n954' class='pln'><a href='#n954'>954</a></p>
 <p id='n955' class='pln'><a href='#n955'>955</a></p>
-<p id='n956' class='pln'><a href='#n956'>956</a></p>
-<p id='n957' class='stm run hide_run'><a href='#n957'>957</a></p>
-<p id='n958' class='stm run hide_run'><a href='#n958'>958</a></p>
-<p id='n959' class='stm run hide_run'><a href='#n959'>959</a></p>
-<p id='n960' class='stm run hide_run'><a href='#n960'>960</a></p>
-<p id='n961' class='stm run hide_run'><a href='#n961'>961</a></p>
+<p id='n956' class='stm run hide_run'><a href='#n956'>956</a></p>
+<p id='n957' class='pln'><a href='#n957'>957</a></p>
+<p id='n958' class='pln'><a href='#n958'>958</a></p>
+<p id='n959' class='pln'><a href='#n959'>959</a></p>
+<p id='n960' class='pln'><a href='#n960'>960</a></p>
+<p id='n961' class='pln'><a href='#n961'>961</a></p>
 <p id='n962' class='pln'><a href='#n962'>962</a></p>
-<p id='n963' class='stm mis'><a href='#n963'>963</a></p>
-<p id='n964' class='pln'><a href='#n964'>964</a></p>
-<p id='n965' class='pln'><a href='#n965'>965</a></p>
-<p id='n966' class='pln'><a href='#n966'>966</a></p>
-<p id='n967' class='pln'><a href='#n967'>967</a></p>
+<p id='n963' class='pln'><a href='#n963'>963</a></p>
+<p id='n964' class='stm run hide_run'><a href='#n964'>964</a></p>
+<p id='n965' class='stm run hide_run'><a href='#n965'>965</a></p>
+<p id='n966' class='stm run hide_run'><a href='#n966'>966</a></p>
+<p id='n967' class='stm run hide_run'><a href='#n967'>967</a></p>
 <p id='n968' class='pln'><a href='#n968'>968</a></p>
-<p id='n969' class='stm run hide_run'><a href='#n969'>969</a></p>
+<p id='n969' class='pln'><a href='#n969'>969</a></p>
 <p id='n970' class='pln'><a href='#n970'>970</a></p>
 <p id='n971' class='pln'><a href='#n971'>971</a></p>
-<p id='n972' class='stm run hide_run'><a href='#n972'>972</a></p>
+<p id='n972' class='pln'><a href='#n972'>972</a></p>
 <p id='n973' class='pln'><a href='#n973'>973</a></p>
-<p id='n974' class='pln'><a href='#n974'>974</a></p>
-<p id='n975' class='pln'><a href='#n975'>975</a></p>
-<p id='n976' class='pln'><a href='#n976'>976</a></p>
-<p id='n977' class='pln'><a href='#n977'>977</a></p>
-<p id='n978' class='pln'><a href='#n978'>978</a></p>
+<p id='n974' class='stm run hide_run'><a href='#n974'>974</a></p>
+<p id='n975' class='stm run hide_run'><a href='#n975'>975</a></p>
+<p id='n976' class='stm run hide_run'><a href='#n976'>976</a></p>
+<p id='n977' class='stm run hide_run'><a href='#n977'>977</a></p>
+<p id='n978' class='stm run hide_run'><a href='#n978'>978</a></p>
 <p id='n979' class='pln'><a href='#n979'>979</a></p>
-<p id='n980' class='pln'><a href='#n980'>980</a></p>
+<p id='n980' class='stm mis'><a href='#n980'>980</a></p>
 <p id='n981' class='pln'><a href='#n981'>981</a></p>
 <p id='n982' class='pln'><a href='#n982'>982</a></p>
 <p id='n983' class='pln'><a href='#n983'>983</a></p>
 <p id='n984' class='pln'><a href='#n984'>984</a></p>
 <p id='n985' class='pln'><a href='#n985'>985</a></p>
 <p id='n986' class='stm run hide_run'><a href='#n986'>986</a></p>
-<p id='n987' class='stm run hide_run'><a href='#n987'>987</a></p>
-<p id='n988' class='stm run hide_run'><a href='#n988'>988</a></p>
+<p id='n987' class='pln'><a href='#n987'>987</a></p>
+<p id='n988' class='pln'><a href='#n988'>988</a></p>
 <p id='n989' class='stm run hide_run'><a href='#n989'>989</a></p>
 <p id='n990' class='pln'><a href='#n990'>990</a></p>
 <p id='n991' class='pln'><a href='#n991'>991</a></p>
 <p id='n992' class='pln'><a href='#n992'>992</a></p>
-<p id='n993' class='stm run hide_run'><a href='#n993'>993</a></p>
+<p id='n993' class='pln'><a href='#n993'>993</a></p>
 <p id='n994' class='pln'><a href='#n994'>994</a></p>
 <p id='n995' class='pln'><a href='#n995'>995</a></p>
 <p id='n996' class='pln'><a href='#n996'>996</a></p>
@@ -1063,95 +1063,95 @@ <h2 class='stats'>
 <p id='n1000' class='pln'><a href='#n1000'>1000</a></p>
 <p id='n1001' class='pln'><a href='#n1001'>1001</a></p>
 <p id='n1002' class='pln'><a href='#n1002'>1002</a></p>
-<p id='n1003' class='pln'><a href='#n1003'>1003</a></p>
-<p id='n1004' class='pln'><a href='#n1004'>1004</a></p>
-<p id='n1005' class='pln'><a href='#n1005'>1005</a></p>
-<p id='n1006' class='pln'><a href='#n1006'>1006</a></p>
+<p id='n1003' class='stm run hide_run'><a href='#n1003'>1003</a></p>
+<p id='n1004' class='stm run hide_run'><a href='#n1004'>1004</a></p>
+<p id='n1005' class='stm run hide_run'><a href='#n1005'>1005</a></p>
+<p id='n1006' class='stm run hide_run'><a href='#n1006'>1006</a></p>
 <p id='n1007' class='pln'><a href='#n1007'>1007</a></p>
-<p id='n1008' class='stm mis'><a href='#n1008'>1008</a></p>
-<p id='n1009' class='stm mis'><a href='#n1009'>1009</a></p>
-<p id='n1010' class='stm mis'><a href='#n1010'>1010</a></p>
-<p id='n1011' class='stm mis'><a href='#n1011'>1011</a></p>
+<p id='n1008' class='pln'><a href='#n1008'>1008</a></p>
+<p id='n1009' class='pln'><a href='#n1009'>1009</a></p>
+<p id='n1010' class='stm run hide_run'><a href='#n1010'>1010</a></p>
+<p id='n1011' class='pln'><a href='#n1011'>1011</a></p>
 <p id='n1012' class='pln'><a href='#n1012'>1012</a></p>
 <p id='n1013' class='pln'><a href='#n1013'>1013</a></p>
 <p id='n1014' class='pln'><a href='#n1014'>1014</a></p>
 <p id='n1015' class='pln'><a href='#n1015'>1015</a></p>
-<p id='n1016' class='stm mis'><a href='#n1016'>1016</a></p>
+<p id='n1016' class='pln'><a href='#n1016'>1016</a></p>
 <p id='n1017' class='pln'><a href='#n1017'>1017</a></p>
-<p id='n1018' class='stm mis'><a href='#n1018'>1018</a></p>
+<p id='n1018' class='pln'><a href='#n1018'>1018</a></p>
 <p id='n1019' class='pln'><a href='#n1019'>1019</a></p>
 <p id='n1020' class='pln'><a href='#n1020'>1020</a></p>
 <p id='n1021' class='pln'><a href='#n1021'>1021</a></p>
 <p id='n1022' class='pln'><a href='#n1022'>1022</a></p>
-<p id='n1023' class='stm mis'><a href='#n1023'>1023</a></p>
+<p id='n1023' class='pln'><a href='#n1023'>1023</a></p>
 <p id='n1024' class='pln'><a href='#n1024'>1024</a></p>
-<p id='n1025' class='pln'><a href='#n1025'>1025</a></p>
+<p id='n1025' class='stm run hide_run'><a href='#n1025'>1025</a></p>
 <p id='n1026' class='stm run hide_run'><a href='#n1026'>1026</a></p>
-<p id='n1027' class='pln'><a href='#n1027'>1027</a></p>
-<p id='n1028' class='pln'><a href='#n1028'>1028</a></p>
+<p id='n1027' class='stm run hide_run'><a href='#n1027'>1027</a></p>
+<p id='n1028' class='stm run hide_run'><a href='#n1028'>1028</a></p>
 <p id='n1029' class='pln'><a href='#n1029'>1029</a></p>
 <p id='n1030' class='pln'><a href='#n1030'>1030</a></p>
 <p id='n1031' class='pln'><a href='#n1031'>1031</a></p>
 <p id='n1032' class='pln'><a href='#n1032'>1032</a></p>
-<p id='n1033' class='pln'><a href='#n1033'>1033</a></p>
+<p id='n1033' class='stm run hide_run'><a href='#n1033'>1033</a></p>
 <p id='n1034' class='pln'><a href='#n1034'>1034</a></p>
-<p id='n1035' class='pln'><a href='#n1035'>1035</a></p>
+<p id='n1035' class='stm mis'><a href='#n1035'>1035</a></p>
 <p id='n1036' class='pln'><a href='#n1036'>1036</a></p>
 <p id='n1037' class='pln'><a href='#n1037'>1037</a></p>
 <p id='n1038' class='pln'><a href='#n1038'>1038</a></p>
 <p id='n1039' class='pln'><a href='#n1039'>1039</a></p>
-<p id='n1040' class='pln'><a href='#n1040'>1040</a></p>
+<p id='n1040' class='stm run hide_run'><a href='#n1040'>1040</a></p>
 <p id='n1041' class='pln'><a href='#n1041'>1041</a></p>
-<p id='n1042' class='stm run hide_run'><a href='#n1042'>1042</a></p>
-<p id='n1043' class='pln'><a href='#n1043'>1043</a></p>
+<p id='n1042' class='pln'><a href='#n1042'>1042</a></p>
+<p id='n1043' class='stm run hide_run'><a href='#n1043'>1043</a></p>
 <p id='n1044' class='pln'><a href='#n1044'>1044</a></p>
-<p id='n1045' class='stm run hide_run'><a href='#n1045'>1045</a></p>
+<p id='n1045' class='pln'><a href='#n1045'>1045</a></p>
 <p id='n1046' class='pln'><a href='#n1046'>1046</a></p>
 <p id='n1047' class='pln'><a href='#n1047'>1047</a></p>
 <p id='n1048' class='pln'><a href='#n1048'>1048</a></p>
-<p id='n1049' class='stm run hide_run'><a href='#n1049'>1049</a></p>
+<p id='n1049' class='pln'><a href='#n1049'>1049</a></p>
 <p id='n1050' class='pln'><a href='#n1050'>1050</a></p>
 <p id='n1051' class='pln'><a href='#n1051'>1051</a></p>
-<p id='n1052' class='stm run hide_run'><a href='#n1052'>1052</a></p>
+<p id='n1052' class='pln'><a href='#n1052'>1052</a></p>
 <p id='n1053' class='pln'><a href='#n1053'>1053</a></p>
 <p id='n1054' class='pln'><a href='#n1054'>1054</a></p>
 <p id='n1055' class='pln'><a href='#n1055'>1055</a></p>
 <p id='n1056' class='pln'><a href='#n1056'>1056</a></p>
 <p id='n1057' class='pln'><a href='#n1057'>1057</a></p>
 <p id='n1058' class='pln'><a href='#n1058'>1058</a></p>
-<p id='n1059' class='pln'><a href='#n1059'>1059</a></p>
-<p id='n1060' class='stm run hide_run'><a href='#n1060'>1060</a></p>
+<p id='n1059' class='stm run hide_run'><a href='#n1059'>1059</a></p>
+<p id='n1060' class='pln'><a href='#n1060'>1060</a></p>
 <p id='n1061' class='pln'><a href='#n1061'>1061</a></p>
-<p id='n1062' class='pln'><a href='#n1062'>1062</a></p>
-<p id='n1063' class='stm run hide_run'><a href='#n1063'>1063</a></p>
+<p id='n1062' class='stm run hide_run'><a href='#n1062'>1062</a></p>
+<p id='n1063' class='pln'><a href='#n1063'>1063</a></p>
 <p id='n1064' class='pln'><a href='#n1064'>1064</a></p>
 <p id='n1065' class='pln'><a href='#n1065'>1065</a></p>
-<p id='n1066' class='pln'><a href='#n1066'>1066</a></p>
+<p id='n1066' class='stm run hide_run'><a href='#n1066'>1066</a></p>
 <p id='n1067' class='pln'><a href='#n1067'>1067</a></p>
 <p id='n1068' class='pln'><a href='#n1068'>1068</a></p>
-<p id='n1069' class='pln'><a href='#n1069'>1069</a></p>
+<p id='n1069' class='stm run hide_run'><a href='#n1069'>1069</a></p>
 <p id='n1070' class='pln'><a href='#n1070'>1070</a></p>
-<p id='n1071' class='stm run hide_run'><a href='#n1071'>1071</a></p>
+<p id='n1071' class='pln'><a href='#n1071'>1071</a></p>
 <p id='n1072' class='pln'><a href='#n1072'>1072</a></p>
 <p id='n1073' class='pln'><a href='#n1073'>1073</a></p>
-<p id='n1074' class='stm run hide_run'><a href='#n1074'>1074</a></p>
+<p id='n1074' class='pln'><a href='#n1074'>1074</a></p>
 <p id='n1075' class='pln'><a href='#n1075'>1075</a></p>
 <p id='n1076' class='pln'><a href='#n1076'>1076</a></p>
-<p id='n1077' class='pln'><a href='#n1077'>1077</a></p>
+<p id='n1077' class='stm run hide_run'><a href='#n1077'>1077</a></p>
 <p id='n1078' class='pln'><a href='#n1078'>1078</a></p>
 <p id='n1079' class='pln'><a href='#n1079'>1079</a></p>
-<p id='n1080' class='pln'><a href='#n1080'>1080</a></p>
+<p id='n1080' class='stm run hide_run'><a href='#n1080'>1080</a></p>
 <p id='n1081' class='pln'><a href='#n1081'>1081</a></p>
 <p id='n1082' class='pln'><a href='#n1082'>1082</a></p>
 <p id='n1083' class='pln'><a href='#n1083'>1083</a></p>
 <p id='n1084' class='pln'><a href='#n1084'>1084</a></p>
 <p id='n1085' class='pln'><a href='#n1085'>1085</a></p>
 <p id='n1086' class='pln'><a href='#n1086'>1086</a></p>
-<p id='n1087' class='stm run hide_run'><a href='#n1087'>1087</a></p>
-<p id='n1088' class='pln'><a href='#n1088'>1088</a></p>
+<p id='n1087' class='pln'><a href='#n1087'>1087</a></p>
+<p id='n1088' class='stm run hide_run'><a href='#n1088'>1088</a></p>
 <p id='n1089' class='pln'><a href='#n1089'>1089</a></p>
-<p id='n1090' class='stm run hide_run'><a href='#n1090'>1090</a></p>
-<p id='n1091' class='pln'><a href='#n1091'>1091</a></p>
+<p id='n1090' class='pln'><a href='#n1090'>1090</a></p>
+<p id='n1091' class='stm run hide_run'><a href='#n1091'>1091</a></p>
 <p id='n1092' class='pln'><a href='#n1092'>1092</a></p>
 <p id='n1093' class='pln'><a href='#n1093'>1093</a></p>
 <p id='n1094' class='pln'><a href='#n1094'>1094</a></p>
@@ -1163,11 +1163,11 @@ <h2 class='stats'>
 <p id='n1100' class='pln'><a href='#n1100'>1100</a></p>
 <p id='n1101' class='pln'><a href='#n1101'>1101</a></p>
 <p id='n1102' class='pln'><a href='#n1102'>1102</a></p>
-<p id='n1103' class='stm run hide_run'><a href='#n1103'>1103</a></p>
-<p id='n1104' class='pln'><a href='#n1104'>1104</a></p>
+<p id='n1103' class='pln'><a href='#n1103'>1103</a></p>
+<p id='n1104' class='stm run hide_run'><a href='#n1104'>1104</a></p>
 <p id='n1105' class='pln'><a href='#n1105'>1105</a></p>
-<p id='n1106' class='stm run hide_run'><a href='#n1106'>1106</a></p>
-<p id='n1107' class='pln'><a href='#n1107'>1107</a></p>
+<p id='n1106' class='pln'><a href='#n1106'>1106</a></p>
+<p id='n1107' class='stm run hide_run'><a href='#n1107'>1107</a></p>
 <p id='n1108' class='pln'><a href='#n1108'>1108</a></p>
 <p id='n1109' class='pln'><a href='#n1109'>1109</a></p>
 <p id='n1110' class='pln'><a href='#n1110'>1110</a></p>
@@ -1179,24 +1179,24 @@ <h2 class='stats'>
 <p id='n1116' class='pln'><a href='#n1116'>1116</a></p>
 <p id='n1117' class='pln'><a href='#n1117'>1117</a></p>
 <p id='n1118' class='pln'><a href='#n1118'>1118</a></p>
-<p id='n1119' class='stm run hide_run'><a href='#n1119'>1119</a></p>
-<p id='n1120' class='pln'><a href='#n1120'>1120</a></p>
+<p id='n1119' class='pln'><a href='#n1119'>1119</a></p>
+<p id='n1120' class='stm run hide_run'><a href='#n1120'>1120</a></p>
 <p id='n1121' class='pln'><a href='#n1121'>1121</a></p>
 <p id='n1122' class='pln'><a href='#n1122'>1122</a></p>
-<p id='n1123' class='pln'><a href='#n1123'>1123</a></p>
+<p id='n1123' class='stm run hide_run'><a href='#n1123'>1123</a></p>
 <p id='n1124' class='pln'><a href='#n1124'>1124</a></p>
 <p id='n1125' class='pln'><a href='#n1125'>1125</a></p>
 <p id='n1126' class='pln'><a href='#n1126'>1126</a></p>
 <p id='n1127' class='pln'><a href='#n1127'>1127</a></p>
 <p id='n1128' class='pln'><a href='#n1128'>1128</a></p>
 <p id='n1129' class='pln'><a href='#n1129'>1129</a></p>
-<p id='n1130' class='stm run hide_run'><a href='#n1130'>1130</a></p>
+<p id='n1130' class='pln'><a href='#n1130'>1130</a></p>
 <p id='n1131' class='pln'><a href='#n1131'>1131</a></p>
 <p id='n1132' class='pln'><a href='#n1132'>1132</a></p>
-<p id='n1133' class='stm run hide_run'><a href='#n1133'>1133</a></p>
+<p id='n1133' class='pln'><a href='#n1133'>1133</a></p>
 <p id='n1134' class='pln'><a href='#n1134'>1134</a></p>
 <p id='n1135' class='pln'><a href='#n1135'>1135</a></p>
-<p id='n1136' class='pln'><a href='#n1136'>1136</a></p>
+<p id='n1136' class='stm run hide_run'><a href='#n1136'>1136</a></p>
 <p id='n1137' class='pln'><a href='#n1137'>1137</a></p>
 <p id='n1138' class='pln'><a href='#n1138'>1138</a></p>
 <p id='n1139' class='pln'><a href='#n1139'>1139</a></p>
@@ -1204,69 +1204,69 @@ <h2 class='stats'>
 <p id='n1141' class='pln'><a href='#n1141'>1141</a></p>
 <p id='n1142' class='pln'><a href='#n1142'>1142</a></p>
 <p id='n1143' class='pln'><a href='#n1143'>1143</a></p>
-<p id='n1144' class='stm run hide_run'><a href='#n1144'>1144</a></p>
+<p id='n1144' class='pln'><a href='#n1144'>1144</a></p>
 <p id='n1145' class='pln'><a href='#n1145'>1145</a></p>
 <p id='n1146' class='pln'><a href='#n1146'>1146</a></p>
 <p id='n1147' class='stm run hide_run'><a href='#n1147'>1147</a></p>
 <p id='n1148' class='pln'><a href='#n1148'>1148</a></p>
 <p id='n1149' class='pln'><a href='#n1149'>1149</a></p>
-<p id='n1150' class='pln'><a href='#n1150'>1150</a></p>
+<p id='n1150' class='stm run hide_run'><a href='#n1150'>1150</a></p>
 <p id='n1151' class='pln'><a href='#n1151'>1151</a></p>
 <p id='n1152' class='pln'><a href='#n1152'>1152</a></p>
 <p id='n1153' class='pln'><a href='#n1153'>1153</a></p>
 <p id='n1154' class='pln'><a href='#n1154'>1154</a></p>
-<p id='n1155' class='stm run hide_run'><a href='#n1155'>1155</a></p>
+<p id='n1155' class='pln'><a href='#n1155'>1155</a></p>
 <p id='n1156' class='pln'><a href='#n1156'>1156</a></p>
 <p id='n1157' class='pln'><a href='#n1157'>1157</a></p>
-<p id='n1158' class='stm run hide_run'><a href='#n1158'>1158</a></p>
+<p id='n1158' class='pln'><a href='#n1158'>1158</a></p>
 <p id='n1159' class='pln'><a href='#n1159'>1159</a></p>
 <p id='n1160' class='pln'><a href='#n1160'>1160</a></p>
-<p id='n1161' class='pln'><a href='#n1161'>1161</a></p>
-<p id='n1162' class='stm run hide_run'><a href='#n1162'>1162</a></p>
+<p id='n1161' class='stm run hide_run'><a href='#n1161'>1161</a></p>
+<p id='n1162' class='pln'><a href='#n1162'>1162</a></p>
 <p id='n1163' class='pln'><a href='#n1163'>1163</a></p>
-<p id='n1164' class='pln'><a href='#n1164'>1164</a></p>
-<p id='n1165' class='stm run hide_run'><a href='#n1165'>1165</a></p>
+<p id='n1164' class='stm run hide_run'><a href='#n1164'>1164</a></p>
+<p id='n1165' class='pln'><a href='#n1165'>1165</a></p>
 <p id='n1166' class='pln'><a href='#n1166'>1166</a></p>
 <p id='n1167' class='pln'><a href='#n1167'>1167</a></p>
 <p id='n1168' class='pln'><a href='#n1168'>1168</a></p>
-<p id='n1169' class='stm run hide_run'><a href='#n1169'>1169</a></p>
+<p id='n1169' class='pln'><a href='#n1169'>1169</a></p>
 <p id='n1170' class='pln'><a href='#n1170'>1170</a></p>
 <p id='n1171' class='pln'><a href='#n1171'>1171</a></p>
 <p id='n1172' class='stm run hide_run'><a href='#n1172'>1172</a></p>
 <p id='n1173' class='pln'><a href='#n1173'>1173</a></p>
 <p id='n1174' class='pln'><a href='#n1174'>1174</a></p>
-<p id='n1175' class='pln'><a href='#n1175'>1175</a></p>
+<p id='n1175' class='stm run hide_run'><a href='#n1175'>1175</a></p>
 <p id='n1176' class='pln'><a href='#n1176'>1176</a></p>
 <p id='n1177' class='pln'><a href='#n1177'>1177</a></p>
 <p id='n1178' class='pln'><a href='#n1178'>1178</a></p>
-<p id='n1179' class='pln'><a href='#n1179'>1179</a></p>
+<p id='n1179' class='stm run hide_run'><a href='#n1179'>1179</a></p>
 <p id='n1180' class='pln'><a href='#n1180'>1180</a></p>
 <p id='n1181' class='pln'><a href='#n1181'>1181</a></p>
-<p id='n1182' class='pln'><a href='#n1182'>1182</a></p>
+<p id='n1182' class='stm run hide_run'><a href='#n1182'>1182</a></p>
 <p id='n1183' class='pln'><a href='#n1183'>1183</a></p>
 <p id='n1184' class='pln'><a href='#n1184'>1184</a></p>
 <p id='n1185' class='pln'><a href='#n1185'>1185</a></p>
-<p id='n1186' class='pln'><a href='#n1186'>1186</a></p>
+<p id='n1186' class='stm run hide_run'><a href='#n1186'>1186</a></p>
 <p id='n1187' class='pln'><a href='#n1187'>1187</a></p>
 <p id='n1188' class='pln'><a href='#n1188'>1188</a></p>
-<p id='n1189' class='pln'><a href='#n1189'>1189</a></p>
+<p id='n1189' class='stm run hide_run'><a href='#n1189'>1189</a></p>
 <p id='n1190' class='pln'><a href='#n1190'>1190</a></p>
 <p id='n1191' class='pln'><a href='#n1191'>1191</a></p>
 <p id='n1192' class='pln'><a href='#n1192'>1192</a></p>
 <p id='n1193' class='pln'><a href='#n1193'>1193</a></p>
 <p id='n1194' class='pln'><a href='#n1194'>1194</a></p>
 <p id='n1195' class='pln'><a href='#n1195'>1195</a></p>
-<p id='n1196' class='stm run hide_run'><a href='#n1196'>1196</a></p>
+<p id='n1196' class='pln'><a href='#n1196'>1196</a></p>
 <p id='n1197' class='pln'><a href='#n1197'>1197</a></p>
 <p id='n1198' class='pln'><a href='#n1198'>1198</a></p>
-<p id='n1199' class='stm run hide_run'><a href='#n1199'>1199</a></p>
+<p id='n1199' class='pln'><a href='#n1199'>1199</a></p>
 <p id='n1200' class='pln'><a href='#n1200'>1200</a></p>
 <p id='n1201' class='pln'><a href='#n1201'>1201</a></p>
 <p id='n1202' class='pln'><a href='#n1202'>1202</a></p>
-<p id='n1203' class='stm run hide_run'><a href='#n1203'>1203</a></p>
+<p id='n1203' class='pln'><a href='#n1203'>1203</a></p>
 <p id='n1204' class='pln'><a href='#n1204'>1204</a></p>
 <p id='n1205' class='pln'><a href='#n1205'>1205</a></p>
-<p id='n1206' class='stm run hide_run'><a href='#n1206'>1206</a></p>
+<p id='n1206' class='pln'><a href='#n1206'>1206</a></p>
 <p id='n1207' class='pln'><a href='#n1207'>1207</a></p>
 <p id='n1208' class='pln'><a href='#n1208'>1208</a></p>
 <p id='n1209' class='pln'><a href='#n1209'>1209</a></p>
@@ -1276,289 +1276,306 @@ <h2 class='stats'>
 <p id='n1213' class='stm run hide_run'><a href='#n1213'>1213</a></p>
 <p id='n1214' class='pln'><a href='#n1214'>1214</a></p>
 <p id='n1215' class='pln'><a href='#n1215'>1215</a></p>
-<p id='n1216' class='pln'><a href='#n1216'>1216</a></p>
-<p id='n1217' class='stm run hide_run'><a href='#n1217'>1217</a></p>
+<p id='n1216' class='stm run hide_run'><a href='#n1216'>1216</a></p>
+<p id='n1217' class='pln'><a href='#n1217'>1217</a></p>
 <p id='n1218' class='pln'><a href='#n1218'>1218</a></p>
 <p id='n1219' class='pln'><a href='#n1219'>1219</a></p>
 <p id='n1220' class='stm run hide_run'><a href='#n1220'>1220</a></p>
 <p id='n1221' class='pln'><a href='#n1221'>1221</a></p>
 <p id='n1222' class='pln'><a href='#n1222'>1222</a></p>
-<p id='n1223' class='pln'><a href='#n1223'>1223</a></p>
-<p id='n1224' class='stm run hide_run'><a href='#n1224'>1224</a></p>
+<p id='n1223' class='stm run hide_run'><a href='#n1223'>1223</a></p>
+<p id='n1224' class='pln'><a href='#n1224'>1224</a></p>
 <p id='n1225' class='pln'><a href='#n1225'>1225</a></p>
 <p id='n1226' class='pln'><a href='#n1226'>1226</a></p>
-<p id='n1227' class='stm run hide_run'><a href='#n1227'>1227</a></p>
+<p id='n1227' class='pln'><a href='#n1227'>1227</a></p>
 <p id='n1228' class='pln'><a href='#n1228'>1228</a></p>
 <p id='n1229' class='pln'><a href='#n1229'>1229</a></p>
-<p id='n1230' class='pln'><a href='#n1230'>1230</a></p>
+<p id='n1230' class='stm run hide_run'><a href='#n1230'>1230</a></p>
 <p id='n1231' class='pln'><a href='#n1231'>1231</a></p>
 <p id='n1232' class='pln'><a href='#n1232'>1232</a></p>
 <p id='n1233' class='pln'><a href='#n1233'>1233</a></p>
-<p id='n1234' class='pln'><a href='#n1234'>1234</a></p>
+<p id='n1234' class='stm run hide_run'><a href='#n1234'>1234</a></p>
 <p id='n1235' class='pln'><a href='#n1235'>1235</a></p>
-<p id='n1236' class='stm run hide_run'><a href='#n1236'>1236</a></p>
+<p id='n1236' class='pln'><a href='#n1236'>1236</a></p>
 <p id='n1237' class='stm run hide_run'><a href='#n1237'>1237</a></p>
-<p id='n1238' class='stm run hide_run'><a href='#n1238'>1238</a></p>
-<p id='n1239' class='stm mis'><a href='#n1239'>1239</a></p>
-<p id='n1240' class='stm run hide_run'><a href='#n1240'>1240</a></p>
-<p id='n1241' class='stm mis'><a href='#n1241'>1241</a></p>
+<p id='n1238' class='pln'><a href='#n1238'>1238</a></p>
+<p id='n1239' class='pln'><a href='#n1239'>1239</a></p>
+<p id='n1240' class='pln'><a href='#n1240'>1240</a></p>
+<p id='n1241' class='stm run hide_run'><a href='#n1241'>1241</a></p>
 <p id='n1242' class='pln'><a href='#n1242'>1242</a></p>
-<p id='n1243' class='stm run hide_run'><a href='#n1243'>1243</a></p>
+<p id='n1243' class='pln'><a href='#n1243'>1243</a></p>
 <p id='n1244' class='stm run hide_run'><a href='#n1244'>1244</a></p>
-<p id='n1245' class='stm run hide_run'><a href='#n1245'>1245</a></p>
-<p id='n1246' class='stm run hide_run'><a href='#n1246'>1246</a></p>
-<p id='n1247' class='stm run hide_run'><a href='#n1247'>1247</a></p>
+<p id='n1245' class='pln'><a href='#n1245'>1245</a></p>
+<p id='n1246' class='pln'><a href='#n1246'>1246</a></p>
+<p id='n1247' class='pln'><a href='#n1247'>1247</a></p>
 <p id='n1248' class='pln'><a href='#n1248'>1248</a></p>
 <p id='n1249' class='pln'><a href='#n1249'>1249</a></p>
-<p id='n1250' class='stm run hide_run'><a href='#n1250'>1250</a></p>
+<p id='n1250' class='pln'><a href='#n1250'>1250</a></p>
 <p id='n1251' class='pln'><a href='#n1251'>1251</a></p>
 <p id='n1252' class='pln'><a href='#n1252'>1252</a></p>
-<p id='n1253' class='pln'><a href='#n1253'>1253</a></p>
+<p id='n1253' class='stm run hide_run'><a href='#n1253'>1253</a></p>
 <p id='n1254' class='stm run hide_run'><a href='#n1254'>1254</a></p>
-<p id='n1255' class='pln'><a href='#n1255'>1255</a></p>
-<p id='n1256' class='pln'><a href='#n1256'>1256</a></p>
+<p id='n1255' class='stm run hide_run'><a href='#n1255'>1255</a></p>
+<p id='n1256' class='stm run hide_run'><a href='#n1256'>1256</a></p>
 <p id='n1257' class='stm run hide_run'><a href='#n1257'>1257</a></p>
-<p id='n1258' class='pln'><a href='#n1258'>1258</a></p>
+<p id='n1258' class='stm run hide_run'><a href='#n1258'>1258</a></p>
 <p id='n1259' class='pln'><a href='#n1259'>1259</a></p>
-<p id='n1260' class='pln'><a href='#n1260'>1260</a></p>
+<p id='n1260' class='stm run hide_run'><a href='#n1260'>1260</a></p>
 <p id='n1261' class='stm run hide_run'><a href='#n1261'>1261</a></p>
 <p id='n1262' class='stm run hide_run'><a href='#n1262'>1262</a></p>
-<p id='n1263' class='pln'><a href='#n1263'>1263</a></p>
+<p id='n1263' class='stm run hide_run'><a href='#n1263'>1263</a></p>
 <p id='n1264' class='stm run hide_run'><a href='#n1264'>1264</a></p>
 <p id='n1265' class='pln'><a href='#n1265'>1265</a></p>
 <p id='n1266' class='pln'><a href='#n1266'>1266</a></p>
-<p id='n1267' class='pln'><a href='#n1267'>1267</a></p>
+<p id='n1267' class='stm run hide_run'><a href='#n1267'>1267</a></p>
 <p id='n1268' class='pln'><a href='#n1268'>1268</a></p>
 <p id='n1269' class='pln'><a href='#n1269'>1269</a></p>
 <p id='n1270' class='pln'><a href='#n1270'>1270</a></p>
-<p id='n1271' class='pln'><a href='#n1271'>1271</a></p>
+<p id='n1271' class='stm run hide_run'><a href='#n1271'>1271</a></p>
 <p id='n1272' class='pln'><a href='#n1272'>1272</a></p>
-<p id='n1273' class='stm run hide_run'><a href='#n1273'>1273</a></p>
+<p id='n1273' class='pln'><a href='#n1273'>1273</a></p>
 <p id='n1274' class='stm run hide_run'><a href='#n1274'>1274</a></p>
-<p id='n1275' class='stm run hide_run'><a href='#n1275'>1275</a></p>
-<p id='n1276' class='stm run hide_run'><a href='#n1276'>1276</a></p>
-<p id='n1277' class='stm run hide_run'><a href='#n1277'>1277</a></p>
+<p id='n1275' class='pln'><a href='#n1275'>1275</a></p>
+<p id='n1276' class='pln'><a href='#n1276'>1276</a></p>
+<p id='n1277' class='pln'><a href='#n1277'>1277</a></p>
 <p id='n1278' class='stm run hide_run'><a href='#n1278'>1278</a></p>
-<p id='n1279' class='stm mis'><a href='#n1279'>1279</a></p>
-<p id='n1280' class='stm run hide_run'><a href='#n1280'>1280</a></p>
+<p id='n1279' class='stm run hide_run'><a href='#n1279'>1279</a></p>
+<p id='n1280' class='pln'><a href='#n1280'>1280</a></p>
 <p id='n1281' class='stm run hide_run'><a href='#n1281'>1281</a></p>
-<p id='n1282' class='stm run hide_run'><a href='#n1282'>1282</a></p>
-<p id='n1283' class='stm run hide_run'><a href='#n1283'>1283</a></p>
-<p id='n1284' class='stm run hide_run'><a href='#n1284'>1284</a></p>
+<p id='n1282' class='pln'><a href='#n1282'>1282</a></p>
+<p id='n1283' class='pln'><a href='#n1283'>1283</a></p>
+<p id='n1284' class='pln'><a href='#n1284'>1284</a></p>
 <p id='n1285' class='pln'><a href='#n1285'>1285</a></p>
-<p id='n1286' class='stm run hide_run'><a href='#n1286'>1286</a></p>
-<p id='n1287' class='stm run hide_run'><a href='#n1287'>1287</a></p>
-<p id='n1288' class='stm run hide_run'><a href='#n1288'>1288</a></p>
-<p id='n1289' class='stm run hide_run'><a href='#n1289'>1289</a></p>
+<p id='n1286' class='pln'><a href='#n1286'>1286</a></p>
+<p id='n1287' class='pln'><a href='#n1287'>1287</a></p>
+<p id='n1288' class='pln'><a href='#n1288'>1288</a></p>
+<p id='n1289' class='pln'><a href='#n1289'>1289</a></p>
 <p id='n1290' class='stm run hide_run'><a href='#n1290'>1290</a></p>
-<p id='n1291' class='pln'><a href='#n1291'>1291</a></p>
+<p id='n1291' class='stm run hide_run'><a href='#n1291'>1291</a></p>
 <p id='n1292' class='stm run hide_run'><a href='#n1292'>1292</a></p>
-<p id='n1293' class='pln'><a href='#n1293'>1293</a></p>
-<p id='n1294' class='pln'><a href='#n1294'>1294</a></p>
-<p id='n1295' class='pln'><a href='#n1295'>1295</a></p>
-<p id='n1296' class='pln'><a href='#n1296'>1296</a></p>
-<p id='n1297' class='pln'><a href='#n1297'>1297</a></p>
-<p id='n1298' class='pln'><a href='#n1298'>1298</a></p>
-<p id='n1299' class='pln'><a href='#n1299'>1299</a></p>
-<p id='n1300' class='pln'><a href='#n1300'>1300</a></p>
-<p id='n1301' class='pln'><a href='#n1301'>1301</a></p>
+<p id='n1293' class='stm run hide_run'><a href='#n1293'>1293</a></p>
+<p id='n1294' class='stm run hide_run'><a href='#n1294'>1294</a></p>
+<p id='n1295' class='stm run hide_run'><a href='#n1295'>1295</a></p>
+<p id='n1296' class='stm mis'><a href='#n1296'>1296</a></p>
+<p id='n1297' class='stm run hide_run'><a href='#n1297'>1297</a></p>
+<p id='n1298' class='stm run hide_run'><a href='#n1298'>1298</a></p>
+<p id='n1299' class='stm run hide_run'><a href='#n1299'>1299</a></p>
+<p id='n1300' class='stm run hide_run'><a href='#n1300'>1300</a></p>
+<p id='n1301' class='stm run hide_run'><a href='#n1301'>1301</a></p>
 <p id='n1302' class='pln'><a href='#n1302'>1302</a></p>
-<p id='n1303' class='pln'><a href='#n1303'>1303</a></p>
-<p id='n1304' class='pln'><a href='#n1304'>1304</a></p>
-<p id='n1305' class='pln'><a href='#n1305'>1305</a></p>
-<p id='n1306' class='pln'><a href='#n1306'>1306</a></p>
-<p id='n1307' class='pln'><a href='#n1307'>1307</a></p>
-<p id='n1308' class='stm mis'><a href='#n1308'>1308</a></p>
-<p id='n1309' class='stm mis'><a href='#n1309'>1309</a></p>
-<p id='n1310' class='stm mis'><a href='#n1310'>1310</a></p>
-<p id='n1311' class='stm mis'><a href='#n1311'>1311</a></p>
-<p id='n1312' class='stm mis'><a href='#n1312'>1312</a></p>
-<p id='n1313' class='stm mis'><a href='#n1313'>1313</a></p>
-<p id='n1314' class='stm mis'><a href='#n1314'>1314</a></p>
-<p id='n1315' class='stm mis'><a href='#n1315'>1315</a></p>
-<p id='n1316' class='stm mis'><a href='#n1316'>1316</a></p>
+<p id='n1303' class='stm run hide_run'><a href='#n1303'>1303</a></p>
+<p id='n1304' class='stm run hide_run'><a href='#n1304'>1304</a></p>
+<p id='n1305' class='stm run hide_run'><a href='#n1305'>1305</a></p>
+<p id='n1306' class='stm run hide_run'><a href='#n1306'>1306</a></p>
+<p id='n1307' class='stm run hide_run'><a href='#n1307'>1307</a></p>
+<p id='n1308' class='pln'><a href='#n1308'>1308</a></p>
+<p id='n1309' class='stm run hide_run'><a href='#n1309'>1309</a></p>
+<p id='n1310' class='pln'><a href='#n1310'>1310</a></p>
+<p id='n1311' class='pln'><a href='#n1311'>1311</a></p>
+<p id='n1312' class='pln'><a href='#n1312'>1312</a></p>
+<p id='n1313' class='pln'><a href='#n1313'>1313</a></p>
+<p id='n1314' class='pln'><a href='#n1314'>1314</a></p>
+<p id='n1315' class='pln'><a href='#n1315'>1315</a></p>
+<p id='n1316' class='pln'><a href='#n1316'>1316</a></p>
 <p id='n1317' class='pln'><a href='#n1317'>1317</a></p>
 <p id='n1318' class='pln'><a href='#n1318'>1318</a></p>
 <p id='n1319' class='pln'><a href='#n1319'>1319</a></p>
-<p id='n1320' class='stm mis'><a href='#n1320'>1320</a></p>
-<p id='n1321' class='stm mis'><a href='#n1321'>1321</a></p>
+<p id='n1320' class='pln'><a href='#n1320'>1320</a></p>
+<p id='n1321' class='pln'><a href='#n1321'>1321</a></p>
 <p id='n1322' class='pln'><a href='#n1322'>1322</a></p>
 <p id='n1323' class='pln'><a href='#n1323'>1323</a></p>
 <p id='n1324' class='pln'><a href='#n1324'>1324</a></p>
-<p id='n1325' class='pln'><a href='#n1325'>1325</a></p>
-<p id='n1326' class='stm mis'><a href='#n1326'>1326</a></p>
+<p id='n1325' class='stm run hide_run'><a href='#n1325'>1325</a></p>
+<p id='n1326' class='stm run hide_run'><a href='#n1326'>1326</a></p>
 <p id='n1327' class='stm mis'><a href='#n1327'>1327</a></p>
-<p id='n1328' class='stm mis'><a href='#n1328'>1328</a></p>
-<p id='n1329' class='stm mis'><a href='#n1329'>1329</a></p>
-<p id='n1330' class='stm mis'><a href='#n1330'>1330</a></p>
-<p id='n1331' class='pln'><a href='#n1331'>1331</a></p>
-<p id='n1332' class='stm mis'><a href='#n1332'>1332</a></p>
-<p id='n1333' class='stm mis'><a href='#n1333'>1333</a></p>
-<p id='n1334' class='stm mis'><a href='#n1334'>1334</a></p>
-<p id='n1335' class='stm mis'><a href='#n1335'>1335</a></p>
-<p id='n1336' class='stm mis'><a href='#n1336'>1336</a></p>
-<p id='n1337' class='stm mis'><a href='#n1337'>1337</a></p>
-<p id='n1338' class='stm mis'><a href='#n1338'>1338</a></p>
-<p id='n1339' class='stm mis'><a href='#n1339'>1339</a></p>
-<p id='n1340' class='stm mis'><a href='#n1340'>1340</a></p>
-<p id='n1341' class='stm mis'><a href='#n1341'>1341</a></p>
+<p id='n1328' class='stm run hide_run'><a href='#n1328'>1328</a></p>
+<p id='n1329' class='stm run hide_run'><a href='#n1329'>1329</a></p>
+<p id='n1330' class='stm run hide_run'><a href='#n1330'>1330</a></p>
+<p id='n1331' class='stm run hide_run'><a href='#n1331'>1331</a></p>
+<p id='n1332' class='stm run hide_run'><a href='#n1332'>1332</a></p>
+<p id='n1333' class='stm run hide_run'><a href='#n1333'>1333</a></p>
+<p id='n1334' class='pln'><a href='#n1334'>1334</a></p>
+<p id='n1335' class='pln'><a href='#n1335'>1335</a></p>
+<p id='n1336' class='pln'><a href='#n1336'>1336</a></p>
+<p id='n1337' class='stm run hide_run'><a href='#n1337'>1337</a></p>
+<p id='n1338' class='stm run hide_run'><a href='#n1338'>1338</a></p>
+<p id='n1339' class='pln'><a href='#n1339'>1339</a></p>
+<p id='n1340' class='pln'><a href='#n1340'>1340</a></p>
+<p id='n1341' class='pln'><a href='#n1341'>1341</a></p>
 <p id='n1342' class='pln'><a href='#n1342'>1342</a></p>
-<p id='n1343' class='pln'><a href='#n1343'>1343</a></p>
-<p id='n1344' class='pln'><a href='#n1344'>1344</a></p>
-<p id='n1345' class='stm mis'><a href='#n1345'>1345</a></p>
-<p id='n1346' class='stm mis'><a href='#n1346'>1346</a></p>
-<p id='n1347' class='pln'><a href='#n1347'>1347</a></p>
+<p id='n1343' class='stm run hide_run'><a href='#n1343'>1343</a></p>
+<p id='n1344' class='stm run hide_run'><a href='#n1344'>1344</a></p>
+<p id='n1345' class='stm run hide_run'><a href='#n1345'>1345</a></p>
+<p id='n1346' class='stm run hide_run'><a href='#n1346'>1346</a></p>
+<p id='n1347' class='stm mis'><a href='#n1347'>1347</a></p>
 <p id='n1348' class='pln'><a href='#n1348'>1348</a></p>
-<p id='n1349' class='pln'><a href='#n1349'>1349</a></p>
-<p id='n1350' class='pln'><a href='#n1350'>1350</a></p>
-<p id='n1351' class='stm mis'><a href='#n1351'>1351</a></p>
-<p id='n1352' class='stm mis'><a href='#n1352'>1352</a></p>
-<p id='n1353' class='stm mis'><a href='#n1353'>1353</a></p>
-<p id='n1354' class='stm mis'><a href='#n1354'>1354</a></p>
-<p id='n1355' class='stm mis'><a href='#n1355'>1355</a></p>
-<p id='n1356' class='stm mis'><a href='#n1356'>1356</a></p>
-<p id='n1357' class='stm mis'><a href='#n1357'>1357</a></p>
-<p id='n1358' class='pln'><a href='#n1358'>1358</a></p>
-<p id='n1359' class='stm run hide_run'><a href='#n1359'>1359</a></p>
+<p id='n1349' class='stm run hide_run'><a href='#n1349'>1349</a></p>
+<p id='n1350' class='stm run hide_run'><a href='#n1350'>1350</a></p>
+<p id='n1351' class='stm run hide_run'><a href='#n1351'>1351</a></p>
+<p id='n1352' class='stm run hide_run'><a href='#n1352'>1352</a></p>
+<p id='n1353' class='stm run hide_run'><a href='#n1353'>1353</a></p>
+<p id='n1354' class='stm run hide_run'><a href='#n1354'>1354</a></p>
+<p id='n1355' class='stm run hide_run'><a href='#n1355'>1355</a></p>
+<p id='n1356' class='stm run hide_run'><a href='#n1356'>1356</a></p>
+<p id='n1357' class='stm run hide_run'><a href='#n1357'>1357</a></p>
+<p id='n1358' class='stm mis'><a href='#n1358'>1358</a></p>
+<p id='n1359' class='pln'><a href='#n1359'>1359</a></p>
 <p id='n1360' class='pln'><a href='#n1360'>1360</a></p>
 <p id='n1361' class='pln'><a href='#n1361'>1361</a></p>
-<p id='n1362' class='pln'><a href='#n1362'>1362</a></p>
-<p id='n1363' class='pln'><a href='#n1363'>1363</a></p>
+<p id='n1362' class='stm mis'><a href='#n1362'>1362</a></p>
+<p id='n1363' class='stm mis'><a href='#n1363'>1363</a></p>
 <p id='n1364' class='pln'><a href='#n1364'>1364</a></p>
 <p id='n1365' class='pln'><a href='#n1365'>1365</a></p>
 <p id='n1366' class='pln'><a href='#n1366'>1366</a></p>
 <p id='n1367' class='pln'><a href='#n1367'>1367</a></p>
-<p id='n1368' class='pln'><a href='#n1368'>1368</a></p>
-<p id='n1369' class='pln'><a href='#n1369'>1369</a></p>
-<p id='n1370' class='pln'><a href='#n1370'>1370</a></p>
-<p id='n1371' class='pln'><a href='#n1371'>1371</a></p>
-<p id='n1372' class='pln'><a href='#n1372'>1372</a></p>
-<p id='n1373' class='pln'><a href='#n1373'>1373</a></p>
+<p id='n1368' class='stm mis'><a href='#n1368'>1368</a></p>
+<p id='n1369' class='stm mis'><a href='#n1369'>1369</a></p>
+<p id='n1370' class='stm mis'><a href='#n1370'>1370</a></p>
+<p id='n1371' class='stm mis'><a href='#n1371'>1371</a></p>
+<p id='n1372' class='stm mis'><a href='#n1372'>1372</a></p>
+<p id='n1373' class='stm run hide_run'><a href='#n1373'>1373</a></p>
 <p id='n1374' class='stm run hide_run'><a href='#n1374'>1374</a></p>
-<p id='n1375' class='stm run hide_run'><a href='#n1375'>1375</a></p>
-<p id='n1376' class='stm mis'><a href='#n1376'>1376</a></p>
-<p id='n1377' class='stm run hide_run'><a href='#n1377'>1377</a></p>
-<p id='n1378' class='stm run hide_run'><a href='#n1378'>1378</a></p>
-<p id='n1379' class='stm run hide_run'><a href='#n1379'>1379</a></p>
-<p id='n1380' class='stm run hide_run'><a href='#n1380'>1380</a></p>
-<p id='n1381' class='stm run hide_run'><a href='#n1381'>1381</a></p>
-<p id='n1382' class='stm mis'><a href='#n1382'>1382</a></p>
-<p id='n1383' class='stm mis'><a href='#n1383'>1383</a></p>
+<p id='n1375' class='pln'><a href='#n1375'>1375</a></p>
+<p id='n1376' class='stm run hide_run'><a href='#n1376'>1376</a></p>
+<p id='n1377' class='pln'><a href='#n1377'>1377</a></p>
+<p id='n1378' class='pln'><a href='#n1378'>1378</a></p>
+<p id='n1379' class='pln'><a href='#n1379'>1379</a></p>
+<p id='n1380' class='pln'><a href='#n1380'>1380</a></p>
+<p id='n1381' class='pln'><a href='#n1381'>1381</a></p>
+<p id='n1382' class='pln'><a href='#n1382'>1382</a></p>
+<p id='n1383' class='pln'><a href='#n1383'>1383</a></p>
 <p id='n1384' class='pln'><a href='#n1384'>1384</a></p>
-<p id='n1385' class='stm run hide_run'><a href='#n1385'>1385</a></p>
-<p id='n1386' class='stm run hide_run'><a href='#n1386'>1386</a></p>
-<p id='n1387' class='stm run hide_run'><a href='#n1387'>1387</a></p>
-<p id='n1388' class='stm run hide_run'><a href='#n1388'>1388</a></p>
-<p id='n1389' class='stm run hide_run'><a href='#n1389'>1389</a></p>
-<p id='n1390' class='stm run hide_run'><a href='#n1390'>1390</a></p>
+<p id='n1385' class='pln'><a href='#n1385'>1385</a></p>
+<p id='n1386' class='pln'><a href='#n1386'>1386</a></p>
+<p id='n1387' class='pln'><a href='#n1387'>1387</a></p>
+<p id='n1388' class='pln'><a href='#n1388'>1388</a></p>
+<p id='n1389' class='pln'><a href='#n1389'>1389</a></p>
+<p id='n1390' class='pln'><a href='#n1390'>1390</a></p>
 <p id='n1391' class='stm run hide_run'><a href='#n1391'>1391</a></p>
 <p id='n1392' class='stm run hide_run'><a href='#n1392'>1392</a></p>
-<p id='n1393' class='stm run hide_run'><a href='#n1393'>1393</a></p>
-<p id='n1394' class='stm mis'><a href='#n1394'>1394</a></p>
+<p id='n1393' class='stm mis'><a href='#n1393'>1393</a></p>
+<p id='n1394' class='stm run hide_run'><a href='#n1394'>1394</a></p>
 <p id='n1395' class='stm run hide_run'><a href='#n1395'>1395</a></p>
-<p id='n1396' class='stm mis'><a href='#n1396'>1396</a></p>
-<p id='n1397' class='pln'><a href='#n1397'>1397</a></p>
-<p id='n1398' class='pln'><a href='#n1398'>1398</a></p>
-<p id='n1399' class='stm run hide_run'><a href='#n1399'>1399</a></p>
-<p id='n1400' class='pln'><a href='#n1400'>1400</a></p>
+<p id='n1396' class='stm run hide_run'><a href='#n1396'>1396</a></p>
+<p id='n1397' class='stm run hide_run'><a href='#n1397'>1397</a></p>
+<p id='n1398' class='stm run hide_run'><a href='#n1398'>1398</a></p>
+<p id='n1399' class='stm mis'><a href='#n1399'>1399</a></p>
+<p id='n1400' class='stm mis'><a href='#n1400'>1400</a></p>
 <p id='n1401' class='pln'><a href='#n1401'>1401</a></p>
-<p id='n1402' class='pln'><a href='#n1402'>1402</a></p>
+<p id='n1402' class='stm run hide_run'><a href='#n1402'>1402</a></p>
 <p id='n1403' class='stm run hide_run'><a href='#n1403'>1403</a></p>
-<p id='n1404' class='pln'><a href='#n1404'>1404</a></p>
-<p id='n1405' class='pln'><a href='#n1405'>1405</a></p>
+<p id='n1404' class='stm run hide_run'><a href='#n1404'>1404</a></p>
+<p id='n1405' class='stm run hide_run'><a href='#n1405'>1405</a></p>
 <p id='n1406' class='stm run hide_run'><a href='#n1406'>1406</a></p>
-<p id='n1407' class='pln'><a href='#n1407'>1407</a></p>
-<p id='n1408' class='pln'><a href='#n1408'>1408</a></p>
-<p id='n1409' class='pln'><a href='#n1409'>1409</a></p>
+<p id='n1407' class='stm run hide_run'><a href='#n1407'>1407</a></p>
+<p id='n1408' class='stm run hide_run'><a href='#n1408'>1408</a></p>
+<p id='n1409' class='stm run hide_run'><a href='#n1409'>1409</a></p>
 <p id='n1410' class='stm run hide_run'><a href='#n1410'>1410</a></p>
-<p id='n1411' class='pln'><a href='#n1411'>1411</a></p>
-<p id='n1412' class='pln'><a href='#n1412'>1412</a></p>
-<p id='n1413' class='stm run hide_run'><a href='#n1413'>1413</a></p>
+<p id='n1411' class='stm mis'><a href='#n1411'>1411</a></p>
+<p id='n1412' class='stm run hide_run'><a href='#n1412'>1412</a></p>
+<p id='n1413' class='stm mis'><a href='#n1413'>1413</a></p>
 <p id='n1414' class='pln'><a href='#n1414'>1414</a></p>
 <p id='n1415' class='pln'><a href='#n1415'>1415</a></p>
-<p id='n1416' class='pln'><a href='#n1416'>1416</a></p>
-<p id='n1417' class='stm run hide_run'><a href='#n1417'>1417</a></p>
+<p id='n1416' class='stm run hide_run'><a href='#n1416'>1416</a></p>
+<p id='n1417' class='pln'><a href='#n1417'>1417</a></p>
 <p id='n1418' class='pln'><a href='#n1418'>1418</a></p>
 <p id='n1419' class='pln'><a href='#n1419'>1419</a></p>
 <p id='n1420' class='stm run hide_run'><a href='#n1420'>1420</a></p>
 <p id='n1421' class='pln'><a href='#n1421'>1421</a></p>
 <p id='n1422' class='pln'><a href='#n1422'>1422</a></p>
-<p id='n1423' class='pln'><a href='#n1423'>1423</a></p>
-<p id='n1424' class='stm run hide_run'><a href='#n1424'>1424</a></p>
+<p id='n1423' class='stm run hide_run'><a href='#n1423'>1423</a></p>
+<p id='n1424' class='pln'><a href='#n1424'>1424</a></p>
 <p id='n1425' class='pln'><a href='#n1425'>1425</a></p>
 <p id='n1426' class='pln'><a href='#n1426'>1426</a></p>
 <p id='n1427' class='stm run hide_run'><a href='#n1427'>1427</a></p>
 <p id='n1428' class='pln'><a href='#n1428'>1428</a></p>
 <p id='n1429' class='pln'><a href='#n1429'>1429</a></p>
-<p id='n1430' class='pln'><a href='#n1430'>1430</a></p>
-<p id='n1431' class='stm run hide_run'><a href='#n1431'>1431</a></p>
+<p id='n1430' class='stm run hide_run'><a href='#n1430'>1430</a></p>
+<p id='n1431' class='pln'><a href='#n1431'>1431</a></p>
 <p id='n1432' class='pln'><a href='#n1432'>1432</a></p>
 <p id='n1433' class='pln'><a href='#n1433'>1433</a></p>
 <p id='n1434' class='stm run hide_run'><a href='#n1434'>1434</a></p>
 <p id='n1435' class='pln'><a href='#n1435'>1435</a></p>
 <p id='n1436' class='pln'><a href='#n1436'>1436</a></p>
-<p id='n1437' class='pln'><a href='#n1437'>1437</a></p>
-<p id='n1438' class='stm run hide_run'><a href='#n1438'>1438</a></p>
+<p id='n1437' class='stm run hide_run'><a href='#n1437'>1437</a></p>
+<p id='n1438' class='pln'><a href='#n1438'>1438</a></p>
 <p id='n1439' class='pln'><a href='#n1439'>1439</a></p>
 <p id='n1440' class='pln'><a href='#n1440'>1440</a></p>
 <p id='n1441' class='stm run hide_run'><a href='#n1441'>1441</a></p>
 <p id='n1442' class='pln'><a href='#n1442'>1442</a></p>
 <p id='n1443' class='pln'><a href='#n1443'>1443</a></p>
-<p id='n1444' class='pln'><a href='#n1444'>1444</a></p>
-<p id='n1445' class='stm run hide_run'><a href='#n1445'>1445</a></p>
+<p id='n1444' class='stm run hide_run'><a href='#n1444'>1444</a></p>
+<p id='n1445' class='pln'><a href='#n1445'>1445</a></p>
 <p id='n1446' class='pln'><a href='#n1446'>1446</a></p>
 <p id='n1447' class='pln'><a href='#n1447'>1447</a></p>
 <p id='n1448' class='stm run hide_run'><a href='#n1448'>1448</a></p>
 <p id='n1449' class='pln'><a href='#n1449'>1449</a></p>
 <p id='n1450' class='pln'><a href='#n1450'>1450</a></p>
-<p id='n1451' class='pln'><a href='#n1451'>1451</a></p>
-<p id='n1452' class='stm run hide_run'><a href='#n1452'>1452</a></p>
+<p id='n1451' class='stm run hide_run'><a href='#n1451'>1451</a></p>
+<p id='n1452' class='pln'><a href='#n1452'>1452</a></p>
 <p id='n1453' class='pln'><a href='#n1453'>1453</a></p>
 <p id='n1454' class='pln'><a href='#n1454'>1454</a></p>
 <p id='n1455' class='stm run hide_run'><a href='#n1455'>1455</a></p>
 <p id='n1456' class='pln'><a href='#n1456'>1456</a></p>
 <p id='n1457' class='pln'><a href='#n1457'>1457</a></p>
-<p id='n1458' class='pln'><a href='#n1458'>1458</a></p>
-<p id='n1459' class='stm run hide_run'><a href='#n1459'>1459</a></p>
+<p id='n1458' class='stm run hide_run'><a href='#n1458'>1458</a></p>
+<p id='n1459' class='pln'><a href='#n1459'>1459</a></p>
 <p id='n1460' class='pln'><a href='#n1460'>1460</a></p>
 <p id='n1461' class='pln'><a href='#n1461'>1461</a></p>
-<p id='n1462' class='pln'><a href='#n1462'>1462</a></p>
-<p id='n1463' class='stm run hide_run'><a href='#n1463'>1463</a></p>
-<p id='n1464' class='stm run hide_run'><a href='#n1464'>1464</a></p>
+<p id='n1462' class='stm run hide_run'><a href='#n1462'>1462</a></p>
+<p id='n1463' class='pln'><a href='#n1463'>1463</a></p>
+<p id='n1464' class='pln'><a href='#n1464'>1464</a></p>
 <p id='n1465' class='stm run hide_run'><a href='#n1465'>1465</a></p>
-<p id='n1466' class='stm run hide_run'><a href='#n1466'>1466</a></p>
-<p id='n1467' class='stm run hide_run'><a href='#n1467'>1467</a></p>
-<p id='n1468' class='stm run hide_run'><a href='#n1468'>1468</a></p>
+<p id='n1466' class='pln'><a href='#n1466'>1466</a></p>
+<p id='n1467' class='pln'><a href='#n1467'>1467</a></p>
+<p id='n1468' class='pln'><a href='#n1468'>1468</a></p>
 <p id='n1469' class='stm run hide_run'><a href='#n1469'>1469</a></p>
-<p id='n1470' class='stm run hide_run'><a href='#n1470'>1470</a></p>
-<p id='n1471' class='stm run hide_run'><a href='#n1471'>1471</a></p>
+<p id='n1470' class='pln'><a href='#n1470'>1470</a></p>
+<p id='n1471' class='pln'><a href='#n1471'>1471</a></p>
 <p id='n1472' class='stm run hide_run'><a href='#n1472'>1472</a></p>
-<p id='n1473' class='stm run hide_run'><a href='#n1473'>1473</a></p>
-<p id='n1474' class='stm run hide_run'><a href='#n1474'>1474</a></p>
-<p id='n1475' class='stm run hide_run'><a href='#n1475'>1475</a></p>
+<p id='n1473' class='pln'><a href='#n1473'>1473</a></p>
+<p id='n1474' class='pln'><a href='#n1474'>1474</a></p>
+<p id='n1475' class='pln'><a href='#n1475'>1475</a></p>
 <p id='n1476' class='stm run hide_run'><a href='#n1476'>1476</a></p>
-<p id='n1477' class='stm run hide_run'><a href='#n1477'>1477</a></p>
-<p id='n1478' class='stm run hide_run'><a href='#n1478'>1478</a></p>
-<p id='n1479' class='stm run hide_run'><a href='#n1479'>1479</a></p>
+<p id='n1477' class='pln'><a href='#n1477'>1477</a></p>
+<p id='n1478' class='pln'><a href='#n1478'>1478</a></p>
+<p id='n1479' class='pln'><a href='#n1479'>1479</a></p>
 <p id='n1480' class='stm run hide_run'><a href='#n1480'>1480</a></p>
-<p id='n1481' class='stm run hide_run'><a href='#n1481'>1481</a></p>
-<p id='n1482' class='stm run hide_run'><a href='#n1482'>1482</a></p>
-<p id='n1483' class='stm run hide_run'><a href='#n1483'>1483</a></p>
-<p id='n1484' class='stm run hide_run'><a href='#n1484'>1484</a></p>
-<p id='n1485' class='stm run hide_run'><a href='#n1485'>1485</a></p>
-<p id='n1486' class='stm run hide_run'><a href='#n1486'>1486</a></p>
-<p id='n1487' class='stm run hide_run'><a href='#n1487'>1487</a></p>
-<p id='n1488' class='stm run hide_run'><a href='#n1488'>1488</a></p>
-<p id='n1489' class='stm run hide_run'><a href='#n1489'>1489</a></p>
-<p id='n1490' class='stm run hide_run'><a href='#n1490'>1490</a></p>
-<p id='n1491' class='stm run hide_run'><a href='#n1491'>1491</a></p>
-<p id='n1492' class='stm run hide_run'><a href='#n1492'>1492</a></p>
-<p id='n1493' class='stm run hide_run'><a href='#n1493'>1493</a></p>
-<p id='n1494' class='stm run hide_run'><a href='#n1494'>1494</a></p>
-<p id='n1495' class='stm run hide_run'><a href='#n1495'>1495</a></p>
-<p id='n1496' class='stm run hide_run'><a href='#n1496'>1496</a></p>
-<p id='n1497' class='stm run hide_run'><a href='#n1497'>1497</a></p>
+<p id='n1481' class='pln'><a href='#n1481'>1481</a></p>
+<p id='n1482' class='pln'><a href='#n1482'>1482</a></p>
+<p id='n1483' class='pln'><a href='#n1483'>1483</a></p>
+<p id='n1484' class='pln'><a href='#n1484'>1484</a></p>
+<p id='n1485' class='pln'><a href='#n1485'>1485</a></p>
+<p id='n1486' class='pln'><a href='#n1486'>1486</a></p>
+<p id='n1487' class='pln'><a href='#n1487'>1487</a></p>
+<p id='n1488' class='pln'><a href='#n1488'>1488</a></p>
+<p id='n1489' class='pln'><a href='#n1489'>1489</a></p>
+<p id='n1490' class='pln'><a href='#n1490'>1490</a></p>
+<p id='n1491' class='pln'><a href='#n1491'>1491</a></p>
+<p id='n1492' class='pln'><a href='#n1492'>1492</a></p>
+<p id='n1493' class='pln'><a href='#n1493'>1493</a></p>
+<p id='n1494' class='pln'><a href='#n1494'>1494</a></p>
+<p id='n1495' class='pln'><a href='#n1495'>1495</a></p>
+<p id='n1496' class='pln'><a href='#n1496'>1496</a></p>
+<p id='n1497' class='pln'><a href='#n1497'>1497</a></p>
 <p id='n1498' class='pln'><a href='#n1498'>1498</a></p>
+<p id='n1499' class='pln'><a href='#n1499'>1499</a></p>
+<p id='n1500' class='pln'><a href='#n1500'>1500</a></p>
+<p id='n1501' class='pln'><a href='#n1501'>1501</a></p>
+<p id='n1502' class='pln'><a href='#n1502'>1502</a></p>
+<p id='n1503' class='pln'><a href='#n1503'>1503</a></p>
+<p id='n1504' class='pln'><a href='#n1504'>1504</a></p>
+<p id='n1505' class='pln'><a href='#n1505'>1505</a></p>
+<p id='n1506' class='pln'><a href='#n1506'>1506</a></p>
+<p id='n1507' class='pln'><a href='#n1507'>1507</a></p>
+<p id='n1508' class='pln'><a href='#n1508'>1508</a></p>
+<p id='n1509' class='pln'><a href='#n1509'>1509</a></p>
+<p id='n1510' class='pln'><a href='#n1510'>1510</a></p>
+<p id='n1511' class='pln'><a href='#n1511'>1511</a></p>
+<p id='n1512' class='pln'><a href='#n1512'>1512</a></p>
+<p id='n1513' class='pln'><a href='#n1513'>1513</a></p>
+<p id='n1514' class='pln'><a href='#n1514'>1514</a></p>
+<p id='n1515' class='pln'><a href='#n1515'>1515</a></p>
                 
             </td>
             <td class='text' valign='top'>
@@ -1586,1480 +1603,1497 @@ <h2 class='stats'>
 <p id='t22' class='pln'><span class='str'>from a dict/list JSON representation.</span><span class='strut'>&nbsp;</span></p>
 <p id='t23' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t24' class='pln'><span class='str'>&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t25' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>warnings</span><span class='strut'>&nbsp;</span></p>
-<p id='t26' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>textwrap</span><span class='strut'>&nbsp;</span></p>
-<p id='t27' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>six</span><span class='strut'>&nbsp;</span></p>
-<p id='t28' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>sys</span><span class='strut'>&nbsp;</span></p>
-<p id='t29' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span> <span class='key'>import</span> <span class='nam'>graph_objs_tools</span><span class='strut'>&nbsp;</span></p>
-<p id='t30' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span><span class='op'>.</span> <span class='key'>import</span> <span class='nam'>exceptions</span><span class='strut'>&nbsp;</span></p>
-<p id='t31' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>plotly</span> <span class='key'>import</span> <span class='nam'>utils</span><span class='strut'>&nbsp;</span></p>
-<p id='t32' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t33' class='stm run hide_run'><span class='key'>if</span> <span class='nam'>sys</span><span class='op'>.</span><span class='nam'>version</span><span class='op'>[</span><span class='op'>:</span><span class='num'>3</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;2.6&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t34' class='stm mis'>&nbsp; &nbsp; <span class='key'>from</span> <span class='nam'>ordereddict</span> <span class='key'>import</span> <span class='nam'>OrderedDict</span><span class='strut'>&nbsp;</span></p>
-<p id='t35' class='stm mis'>&nbsp; &nbsp; <span class='key'>import</span> <span class='nam'>simplejson</span> <span class='key'>as</span> <span class='nam'>json</span><span class='strut'>&nbsp;</span></p>
-<p id='t36' class='pln'><span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t37' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>from</span> <span class='nam'>collections</span> <span class='key'>import</span> <span class='nam'>OrderedDict</span><span class='strut'>&nbsp;</span></p>
-<p id='t38' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>import</span> <span class='nam'>json</span><span class='strut'>&nbsp;</span></p>
-<p id='t39' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t40' class='stm run hide_run'><span class='nam'>__all__</span> <span class='op'>=</span> <span class='op'>[</span><span class='str'>&quot;Data&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t41' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Annotations&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t42' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Area&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t43' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Bar&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t44' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Box&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t45' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Contour&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t46' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Heatmap&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t47' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Histogram&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t48' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Histogram2d&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t49' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Histogram2dContour&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t50' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Scatter&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t51' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Annotation&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t52' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;AngularAxis&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t53' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;ColorBar&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t54' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Contours&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t55' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;ErrorX&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t56' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;ErrorY&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t57' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Figure&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t58' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Font&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t59' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Layout&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t60' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Legend&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t61' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Line&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t62' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Margin&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t63' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Marker&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t64' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;RadialAxis&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t65' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Stream&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t66' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Trace&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t67' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;XAxis&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t68' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;XBins&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t69' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;YAxis&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t70' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;YBins&quot;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t71' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t72' class='pln'><span class='com'># TODO: BIG ONE, how should exceptions bubble up in this inheritance scheme?</span><span class='strut'>&nbsp;</span></p>
-<p id='t73' class='pln'>&nbsp; &nbsp; <span class='com'># TODO: related, WHAT exceptions should bubble up?</span><span class='strut'>&nbsp;</span></p>
+<p id='t25' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>__future__</span> <span class='key'>import</span> <span class='nam'>absolute_import</span><span class='strut'>&nbsp;</span></p>
+<p id='t26' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t27' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>warnings</span><span class='strut'>&nbsp;</span></p>
+<p id='t28' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>textwrap</span><span class='strut'>&nbsp;</span></p>
+<p id='t29' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>six</span><span class='strut'>&nbsp;</span></p>
+<p id='t30' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>sys</span><span class='strut'>&nbsp;</span></p>
+<p id='t31' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>plotly</span><span class='op'>.</span><span class='nam'>graph_objs</span> <span class='key'>import</span> <span class='nam'>graph_objs_tools</span><span class='strut'>&nbsp;</span></p>
+<p id='t32' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>copy</span><span class='strut'>&nbsp;</span></p>
+<p id='t33' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>plotly</span> <span class='key'>import</span> <span class='nam'>exceptions</span><span class='strut'>&nbsp;</span></p>
+<p id='t34' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>plotly</span> <span class='key'>import</span> <span class='nam'>utils</span><span class='strut'>&nbsp;</span></p>
+<p id='t35' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t36' class='stm run hide_run'><span class='key'>if</span> <span class='nam'>sys</span><span class='op'>.</span><span class='nam'>version</span><span class='op'>[</span><span class='op'>:</span><span class='num'>3</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;2.6&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t37' class='stm mis'>&nbsp; &nbsp; <span class='key'>from</span> <span class='nam'>ordereddict</span> <span class='key'>import</span> <span class='nam'>OrderedDict</span><span class='strut'>&nbsp;</span></p>
+<p id='t38' class='stm mis'>&nbsp; &nbsp; <span class='key'>import</span> <span class='nam'>simplejson</span> <span class='key'>as</span> <span class='nam'>json</span><span class='strut'>&nbsp;</span></p>
+<p id='t39' class='pln'><span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t40' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>from</span> <span class='nam'>collections</span> <span class='key'>import</span> <span class='nam'>OrderedDict</span><span class='strut'>&nbsp;</span></p>
+<p id='t41' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>import</span> <span class='nam'>json</span><span class='strut'>&nbsp;</span></p>
+<p id='t42' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t43' class='stm run hide_run'><span class='nam'>__all__</span> <span class='op'>=</span> <span class='op'>[</span><span class='str'>&quot;Data&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t44' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Annotations&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t45' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Area&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t46' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Bar&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t47' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Box&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t48' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Contour&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t49' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Heatmap&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t50' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Histogram&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t51' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Histogram2d&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t52' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Histogram2dContour&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t53' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Scatter&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t54' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Annotation&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t55' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;AngularAxis&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t56' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;ColorBar&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t57' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Contours&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t58' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;ErrorX&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t59' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;ErrorY&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t60' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Figure&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t61' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Font&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t62' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Layout&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t63' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Legend&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t64' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Line&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t65' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Margin&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t66' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Marker&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t67' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;RadialAxis&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t68' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Stream&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t69' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Trace&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t70' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;XAxis&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t71' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;XBins&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t72' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;YAxis&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t73' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;YBins&quot;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
 <p id='t74' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t75' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>pkg_resources</span> <span class='key'>import</span> <span class='nam'>resource_string</span><span class='strut'>&nbsp;</span></p>
-<p id='t76' class='stm run hide_run'><span class='nam'>s</span> <span class='op'>=</span> <span class='nam'>resource_string</span><span class='op'>(</span><span class='str'>&#39;plotly&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t77' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;graph_reference/graph_objs_meta.json&#39;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>decode</span><span class='op'>(</span><span class='str'>&#39;utf-8&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t78' class='stm run hide_run'><span class='nam'>INFO</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>s</span><span class='op'>,</span> <span class='nam'>object_pairs_hook</span><span class='op'>=</span><span class='nam'>OrderedDict</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t79' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t80' class='stm run hide_run'><span class='nam'>INFO</span> <span class='op'>=</span> <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>decode_unicode</span><span class='op'>(</span><span class='nam'>INFO</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t81' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t82' class='pln'><span class='com'># define how to map from keys in INFO to a class</span><span class='strut'>&nbsp;</span></p>
-<p id='t83' class='pln'><span class='com'># mapping: (n-&gt;m, m &lt; n)</span><span class='strut'>&nbsp;</span></p>
-<p id='t84' class='stm run hide_run'><span class='nam'>KEY_TO_NAME</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t85' class='pln'>&nbsp; &nbsp; <span class='nam'>plotlylist</span><span class='op'>=</span><span class='str'>&#39;PlotlyList&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t86' class='pln'>&nbsp; &nbsp; <span class='nam'>data</span><span class='op'>=</span><span class='str'>&#39;Data&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t87' class='pln'>&nbsp; &nbsp; <span class='nam'>angularaxis</span><span class='op'>=</span><span class='str'>&#39;AngularAxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t88' class='pln'>&nbsp; &nbsp; <span class='nam'>annotations</span><span class='op'>=</span><span class='str'>&#39;Annotations&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t89' class='pln'>&nbsp; &nbsp; <span class='nam'>area</span><span class='op'>=</span><span class='str'>&#39;Area&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t90' class='pln'>&nbsp; &nbsp; <span class='nam'>plotlydict</span><span class='op'>=</span><span class='str'>&#39;PlotlyDict&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t91' class='pln'>&nbsp; &nbsp; <span class='nam'>plotlytrace</span><span class='op'>=</span><span class='str'>&#39;PlotlyTrace&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t92' class='pln'>&nbsp; &nbsp; <span class='nam'>bar</span><span class='op'>=</span><span class='str'>&#39;Bar&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t93' class='pln'>&nbsp; &nbsp; <span class='nam'>box</span><span class='op'>=</span><span class='str'>&#39;Box&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t94' class='pln'>&nbsp; &nbsp; <span class='nam'>contour</span><span class='op'>=</span><span class='str'>&#39;Contour&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t95' class='pln'>&nbsp; &nbsp; <span class='nam'>heatmap</span><span class='op'>=</span><span class='str'>&#39;Heatmap&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t96' class='pln'>&nbsp; &nbsp; <span class='nam'>histogram</span><span class='op'>=</span><span class='str'>&#39;Histogram&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t97' class='pln'>&nbsp; &nbsp; <span class='nam'>histogram2d</span><span class='op'>=</span><span class='str'>&#39;Histogram2d&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t98' class='pln'>&nbsp; &nbsp; <span class='nam'>histogram2dcontour</span><span class='op'>=</span><span class='str'>&#39;Histogram2dContour&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t99' class='pln'>&nbsp; &nbsp; <span class='nam'>scatter</span><span class='op'>=</span><span class='str'>&#39;Scatter&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t100' class='pln'>&nbsp; &nbsp; <span class='nam'>annotation</span><span class='op'>=</span><span class='str'>&#39;Annotation&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t101' class='pln'>&nbsp; &nbsp; <span class='nam'>colorbar</span><span class='op'>=</span><span class='str'>&#39;ColorBar&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t102' class='pln'>&nbsp; &nbsp; <span class='nam'>contours</span><span class='op'>=</span><span class='str'>&#39;Contours&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t103' class='pln'>&nbsp; &nbsp; <span class='nam'>error_x</span><span class='op'>=</span><span class='str'>&#39;ErrorX&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t104' class='pln'>&nbsp; &nbsp; <span class='nam'>error_y</span><span class='op'>=</span><span class='str'>&#39;ErrorY&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t105' class='pln'>&nbsp; &nbsp; <span class='nam'>figure</span><span class='op'>=</span><span class='str'>&#39;Figure&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t106' class='pln'>&nbsp; &nbsp; <span class='nam'>font</span><span class='op'>=</span><span class='str'>&#39;Font&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t107' class='pln'>&nbsp; &nbsp; <span class='nam'>layout</span><span class='op'>=</span><span class='str'>&#39;Layout&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t108' class='pln'>&nbsp; &nbsp; <span class='nam'>legend</span><span class='op'>=</span><span class='str'>&#39;Legend&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t109' class='pln'>&nbsp; &nbsp; <span class='nam'>line</span><span class='op'>=</span><span class='str'>&#39;Line&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t110' class='pln'>&nbsp; &nbsp; <span class='nam'>margin</span><span class='op'>=</span><span class='str'>&#39;Margin&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t111' class='pln'>&nbsp; &nbsp; <span class='nam'>marker</span><span class='op'>=</span><span class='str'>&#39;Marker&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t112' class='pln'>&nbsp; &nbsp; <span class='nam'>radialaxis</span><span class='op'>=</span><span class='str'>&#39;RadialAxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t113' class='pln'>&nbsp; &nbsp; <span class='nam'>stream</span><span class='op'>=</span><span class='str'>&#39;Stream&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t114' class='pln'>&nbsp; &nbsp; <span class='nam'>trace</span><span class='op'>=</span><span class='str'>&#39;Trace&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t115' class='pln'>&nbsp; &nbsp; <span class='nam'>textfont</span><span class='op'>=</span><span class='str'>&#39;Font&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t116' class='pln'>&nbsp; &nbsp; <span class='nam'>tickfont</span><span class='op'>=</span><span class='str'>&#39;Font&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t117' class='pln'>&nbsp; &nbsp; <span class='nam'>titlefont</span><span class='op'>=</span><span class='str'>&#39;Font&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t118' class='pln'>&nbsp; &nbsp; <span class='nam'>xaxis</span><span class='op'>=</span><span class='str'>&#39;XAxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t119' class='pln'>&nbsp; &nbsp; <span class='nam'>xbins</span><span class='op'>=</span><span class='str'>&#39;XBins&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t120' class='pln'>&nbsp; &nbsp; <span class='nam'>yaxis</span><span class='op'>=</span><span class='str'>&#39;YAxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t121' class='pln'>&nbsp; &nbsp; <span class='nam'>ybins</span><span class='op'>=</span><span class='str'>&#39;YBins&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t122' class='pln'><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t123' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t124' class='pln'><span class='com'># define how to map from a class name to a key name in INFO</span><span class='strut'>&nbsp;</span></p>
-<p id='t125' class='pln'><span class='com'># mapping: (n-&gt;n)</span><span class='strut'>&nbsp;</span></p>
-<p id='t126' class='stm run hide_run'><span class='nam'>NAME_TO_KEY</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t127' class='pln'>&nbsp; &nbsp; <span class='nam'>PlotlyList</span><span class='op'>=</span><span class='str'>&#39;plotlylist&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t128' class='pln'>&nbsp; &nbsp; <span class='nam'>Data</span><span class='op'>=</span><span class='str'>&#39;data&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t129' class='pln'>&nbsp; &nbsp; <span class='nam'>AngularAxis</span><span class='op'>=</span><span class='str'>&#39;angularaxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t130' class='pln'>&nbsp; &nbsp; <span class='nam'>Annotations</span><span class='op'>=</span><span class='str'>&#39;annotations&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t131' class='pln'>&nbsp; &nbsp; <span class='nam'>PlotlyDict</span><span class='op'>=</span><span class='str'>&#39;plotlydict&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t132' class='pln'>&nbsp; &nbsp; <span class='nam'>PlotlyTrace</span><span class='op'>=</span><span class='str'>&#39;plotlytrace&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t133' class='pln'>&nbsp; &nbsp; <span class='nam'>Area</span><span class='op'>=</span><span class='str'>&#39;area&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t134' class='pln'>&nbsp; &nbsp; <span class='nam'>Bar</span><span class='op'>=</span><span class='str'>&#39;bar&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t135' class='pln'>&nbsp; &nbsp; <span class='nam'>Box</span><span class='op'>=</span><span class='str'>&#39;box&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t136' class='pln'>&nbsp; &nbsp; <span class='nam'>Contour</span><span class='op'>=</span><span class='str'>&#39;contour&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t137' class='pln'>&nbsp; &nbsp; <span class='nam'>Heatmap</span><span class='op'>=</span><span class='str'>&#39;heatmap&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t138' class='pln'>&nbsp; &nbsp; <span class='nam'>Histogram</span><span class='op'>=</span><span class='str'>&#39;histogram&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t139' class='pln'>&nbsp; &nbsp; <span class='nam'>Histogram2d</span><span class='op'>=</span><span class='str'>&#39;histogram2d&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t140' class='pln'>&nbsp; &nbsp; <span class='nam'>Histogram2dContour</span><span class='op'>=</span><span class='str'>&#39;histogram2dcontour&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t141' class='pln'>&nbsp; &nbsp; <span class='nam'>Scatter</span><span class='op'>=</span><span class='str'>&#39;scatter&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t142' class='pln'>&nbsp; &nbsp; <span class='nam'>Annotation</span><span class='op'>=</span><span class='str'>&#39;annotation&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t143' class='pln'>&nbsp; &nbsp; <span class='nam'>ColorBar</span><span class='op'>=</span><span class='str'>&#39;colorbar&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t144' class='pln'>&nbsp; &nbsp; <span class='nam'>Contours</span><span class='op'>=</span><span class='str'>&#39;contours&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t145' class='pln'>&nbsp; &nbsp; <span class='nam'>ErrorX</span><span class='op'>=</span><span class='str'>&#39;error_x&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t146' class='pln'>&nbsp; &nbsp; <span class='nam'>ErrorY</span><span class='op'>=</span><span class='str'>&#39;error_y&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t147' class='pln'>&nbsp; &nbsp; <span class='nam'>Figure</span><span class='op'>=</span><span class='str'>&#39;figure&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t148' class='pln'>&nbsp; &nbsp; <span class='nam'>Font</span><span class='op'>=</span><span class='str'>&#39;font&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t149' class='pln'>&nbsp; &nbsp; <span class='nam'>Layout</span><span class='op'>=</span><span class='str'>&#39;layout&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t150' class='pln'>&nbsp; &nbsp; <span class='nam'>Legend</span><span class='op'>=</span><span class='str'>&#39;legend&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t151' class='pln'>&nbsp; &nbsp; <span class='nam'>Line</span><span class='op'>=</span><span class='str'>&#39;line&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t152' class='pln'>&nbsp; &nbsp; <span class='nam'>Margin</span><span class='op'>=</span><span class='str'>&#39;margin&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t153' class='pln'>&nbsp; &nbsp; <span class='nam'>Marker</span><span class='op'>=</span><span class='str'>&#39;marker&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t154' class='pln'>&nbsp; &nbsp; <span class='nam'>RadialAxis</span><span class='op'>=</span><span class='str'>&#39;radialaxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t155' class='pln'>&nbsp; &nbsp; <span class='nam'>Stream</span><span class='op'>=</span><span class='str'>&#39;stream&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t156' class='pln'>&nbsp; &nbsp; <span class='nam'>Trace</span><span class='op'>=</span><span class='str'>&#39;trace&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t157' class='pln'>&nbsp; &nbsp; <span class='nam'>XAxis</span><span class='op'>=</span><span class='str'>&#39;xaxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t158' class='pln'>&nbsp; &nbsp; <span class='nam'>XBins</span><span class='op'>=</span><span class='str'>&#39;xbins&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t159' class='pln'>&nbsp; &nbsp; <span class='nam'>YAxis</span><span class='op'>=</span><span class='str'>&#39;yaxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t160' class='pln'>&nbsp; &nbsp; <span class='nam'>YBins</span><span class='op'>=</span><span class='str'>&#39;ybins&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t161' class='pln'><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t162' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t163' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t164' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>ListMeta</span><span class='op'>(</span><span class='nam'>type</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t165' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A meta class for PlotlyList class creation.</span><span class='strut'>&nbsp;</span></p>
+<p id='t75' class='pln'><span class='com'># TODO: BIG ONE, how should exceptions bubble up in this inheritance scheme?</span><span class='strut'>&nbsp;</span></p>
+<p id='t76' class='pln'>&nbsp; &nbsp; <span class='com'># TODO: related, WHAT exceptions should bubble up?</span><span class='strut'>&nbsp;</span></p>
+<p id='t77' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t78' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>pkg_resources</span> <span class='key'>import</span> <span class='nam'>resource_string</span><span class='strut'>&nbsp;</span></p>
+<p id='t79' class='stm run hide_run'><span class='nam'>s</span> <span class='op'>=</span> <span class='nam'>resource_string</span><span class='op'>(</span><span class='str'>&#39;plotly&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t80' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;graph_reference/graph_objs_meta.json&#39;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>decode</span><span class='op'>(</span><span class='str'>&#39;utf-8&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t81' class='stm run hide_run'><span class='nam'>INFO</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>s</span><span class='op'>,</span> <span class='nam'>object_pairs_hook</span><span class='op'>=</span><span class='nam'>OrderedDict</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t82' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t83' class='stm run hide_run'><span class='nam'>INFO</span> <span class='op'>=</span> <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>decode_unicode</span><span class='op'>(</span><span class='nam'>INFO</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t84' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t85' class='pln'><span class='com'># define how to map from keys in INFO to a class</span><span class='strut'>&nbsp;</span></p>
+<p id='t86' class='pln'><span class='com'># mapping: (n-&gt;m, m &lt; n)</span><span class='strut'>&nbsp;</span></p>
+<p id='t87' class='stm run hide_run'><span class='nam'>KEY_TO_NAME</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t88' class='pln'>&nbsp; &nbsp; <span class='nam'>plotlylist</span><span class='op'>=</span><span class='str'>&#39;PlotlyList&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t89' class='pln'>&nbsp; &nbsp; <span class='nam'>data</span><span class='op'>=</span><span class='str'>&#39;Data&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t90' class='pln'>&nbsp; &nbsp; <span class='nam'>angularaxis</span><span class='op'>=</span><span class='str'>&#39;AngularAxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t91' class='pln'>&nbsp; &nbsp; <span class='nam'>annotations</span><span class='op'>=</span><span class='str'>&#39;Annotations&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t92' class='pln'>&nbsp; &nbsp; <span class='nam'>area</span><span class='op'>=</span><span class='str'>&#39;Area&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t93' class='pln'>&nbsp; &nbsp; <span class='nam'>plotlydict</span><span class='op'>=</span><span class='str'>&#39;PlotlyDict&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t94' class='pln'>&nbsp; &nbsp; <span class='nam'>plotlytrace</span><span class='op'>=</span><span class='str'>&#39;PlotlyTrace&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t95' class='pln'>&nbsp; &nbsp; <span class='nam'>bar</span><span class='op'>=</span><span class='str'>&#39;Bar&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t96' class='pln'>&nbsp; &nbsp; <span class='nam'>box</span><span class='op'>=</span><span class='str'>&#39;Box&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t97' class='pln'>&nbsp; &nbsp; <span class='nam'>contour</span><span class='op'>=</span><span class='str'>&#39;Contour&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t98' class='pln'>&nbsp; &nbsp; <span class='nam'>heatmap</span><span class='op'>=</span><span class='str'>&#39;Heatmap&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t99' class='pln'>&nbsp; &nbsp; <span class='nam'>histogram</span><span class='op'>=</span><span class='str'>&#39;Histogram&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t100' class='pln'>&nbsp; &nbsp; <span class='nam'>histogram2d</span><span class='op'>=</span><span class='str'>&#39;Histogram2d&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t101' class='pln'>&nbsp; &nbsp; <span class='nam'>histogram2dcontour</span><span class='op'>=</span><span class='str'>&#39;Histogram2dContour&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t102' class='pln'>&nbsp; &nbsp; <span class='nam'>scatter</span><span class='op'>=</span><span class='str'>&#39;Scatter&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t103' class='pln'>&nbsp; &nbsp; <span class='nam'>annotation</span><span class='op'>=</span><span class='str'>&#39;Annotation&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t104' class='pln'>&nbsp; &nbsp; <span class='nam'>colorbar</span><span class='op'>=</span><span class='str'>&#39;ColorBar&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t105' class='pln'>&nbsp; &nbsp; <span class='nam'>contours</span><span class='op'>=</span><span class='str'>&#39;Contours&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t106' class='pln'>&nbsp; &nbsp; <span class='nam'>error_x</span><span class='op'>=</span><span class='str'>&#39;ErrorX&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t107' class='pln'>&nbsp; &nbsp; <span class='nam'>error_y</span><span class='op'>=</span><span class='str'>&#39;ErrorY&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t108' class='pln'>&nbsp; &nbsp; <span class='nam'>figure</span><span class='op'>=</span><span class='str'>&#39;Figure&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t109' class='pln'>&nbsp; &nbsp; <span class='nam'>font</span><span class='op'>=</span><span class='str'>&#39;Font&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t110' class='pln'>&nbsp; &nbsp; <span class='nam'>layout</span><span class='op'>=</span><span class='str'>&#39;Layout&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t111' class='pln'>&nbsp; &nbsp; <span class='nam'>legend</span><span class='op'>=</span><span class='str'>&#39;Legend&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t112' class='pln'>&nbsp; &nbsp; <span class='nam'>line</span><span class='op'>=</span><span class='str'>&#39;Line&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t113' class='pln'>&nbsp; &nbsp; <span class='nam'>margin</span><span class='op'>=</span><span class='str'>&#39;Margin&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t114' class='pln'>&nbsp; &nbsp; <span class='nam'>marker</span><span class='op'>=</span><span class='str'>&#39;Marker&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t115' class='pln'>&nbsp; &nbsp; <span class='nam'>radialaxis</span><span class='op'>=</span><span class='str'>&#39;RadialAxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t116' class='pln'>&nbsp; &nbsp; <span class='nam'>stream</span><span class='op'>=</span><span class='str'>&#39;Stream&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t117' class='pln'>&nbsp; &nbsp; <span class='nam'>trace</span><span class='op'>=</span><span class='str'>&#39;Trace&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t118' class='pln'>&nbsp; &nbsp; <span class='nam'>textfont</span><span class='op'>=</span><span class='str'>&#39;Font&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t119' class='pln'>&nbsp; &nbsp; <span class='nam'>tickfont</span><span class='op'>=</span><span class='str'>&#39;Font&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t120' class='pln'>&nbsp; &nbsp; <span class='nam'>titlefont</span><span class='op'>=</span><span class='str'>&#39;Font&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t121' class='pln'>&nbsp; &nbsp; <span class='nam'>xaxis</span><span class='op'>=</span><span class='str'>&#39;XAxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t122' class='pln'>&nbsp; &nbsp; <span class='nam'>xbins</span><span class='op'>=</span><span class='str'>&#39;XBins&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t123' class='pln'>&nbsp; &nbsp; <span class='nam'>yaxis</span><span class='op'>=</span><span class='str'>&#39;YAxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t124' class='pln'>&nbsp; &nbsp; <span class='nam'>ybins</span><span class='op'>=</span><span class='str'>&#39;YBins&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t125' class='pln'><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t126' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t127' class='pln'><span class='com'># define how to map from a class name to a key name in INFO</span><span class='strut'>&nbsp;</span></p>
+<p id='t128' class='pln'><span class='com'># mapping: (n-&gt;n)</span><span class='strut'>&nbsp;</span></p>
+<p id='t129' class='stm run hide_run'><span class='nam'>NAME_TO_KEY</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t130' class='pln'>&nbsp; &nbsp; <span class='nam'>PlotlyList</span><span class='op'>=</span><span class='str'>&#39;plotlylist&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t131' class='pln'>&nbsp; &nbsp; <span class='nam'>Data</span><span class='op'>=</span><span class='str'>&#39;data&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t132' class='pln'>&nbsp; &nbsp; <span class='nam'>AngularAxis</span><span class='op'>=</span><span class='str'>&#39;angularaxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t133' class='pln'>&nbsp; &nbsp; <span class='nam'>Annotations</span><span class='op'>=</span><span class='str'>&#39;annotations&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t134' class='pln'>&nbsp; &nbsp; <span class='nam'>PlotlyDict</span><span class='op'>=</span><span class='str'>&#39;plotlydict&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t135' class='pln'>&nbsp; &nbsp; <span class='nam'>PlotlyTrace</span><span class='op'>=</span><span class='str'>&#39;plotlytrace&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t136' class='pln'>&nbsp; &nbsp; <span class='nam'>Area</span><span class='op'>=</span><span class='str'>&#39;area&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t137' class='pln'>&nbsp; &nbsp; <span class='nam'>Bar</span><span class='op'>=</span><span class='str'>&#39;bar&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t138' class='pln'>&nbsp; &nbsp; <span class='nam'>Box</span><span class='op'>=</span><span class='str'>&#39;box&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t139' class='pln'>&nbsp; &nbsp; <span class='nam'>Contour</span><span class='op'>=</span><span class='str'>&#39;contour&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t140' class='pln'>&nbsp; &nbsp; <span class='nam'>Heatmap</span><span class='op'>=</span><span class='str'>&#39;heatmap&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t141' class='pln'>&nbsp; &nbsp; <span class='nam'>Histogram</span><span class='op'>=</span><span class='str'>&#39;histogram&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t142' class='pln'>&nbsp; &nbsp; <span class='nam'>Histogram2d</span><span class='op'>=</span><span class='str'>&#39;histogram2d&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t143' class='pln'>&nbsp; &nbsp; <span class='nam'>Histogram2dContour</span><span class='op'>=</span><span class='str'>&#39;histogram2dcontour&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t144' class='pln'>&nbsp; &nbsp; <span class='nam'>Scatter</span><span class='op'>=</span><span class='str'>&#39;scatter&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t145' class='pln'>&nbsp; &nbsp; <span class='nam'>Annotation</span><span class='op'>=</span><span class='str'>&#39;annotation&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t146' class='pln'>&nbsp; &nbsp; <span class='nam'>ColorBar</span><span class='op'>=</span><span class='str'>&#39;colorbar&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t147' class='pln'>&nbsp; &nbsp; <span class='nam'>Contours</span><span class='op'>=</span><span class='str'>&#39;contours&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t148' class='pln'>&nbsp; &nbsp; <span class='nam'>ErrorX</span><span class='op'>=</span><span class='str'>&#39;error_x&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t149' class='pln'>&nbsp; &nbsp; <span class='nam'>ErrorY</span><span class='op'>=</span><span class='str'>&#39;error_y&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t150' class='pln'>&nbsp; &nbsp; <span class='nam'>Figure</span><span class='op'>=</span><span class='str'>&#39;figure&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t151' class='pln'>&nbsp; &nbsp; <span class='nam'>Font</span><span class='op'>=</span><span class='str'>&#39;font&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t152' class='pln'>&nbsp; &nbsp; <span class='nam'>Layout</span><span class='op'>=</span><span class='str'>&#39;layout&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t153' class='pln'>&nbsp; &nbsp; <span class='nam'>Legend</span><span class='op'>=</span><span class='str'>&#39;legend&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t154' class='pln'>&nbsp; &nbsp; <span class='nam'>Line</span><span class='op'>=</span><span class='str'>&#39;line&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t155' class='pln'>&nbsp; &nbsp; <span class='nam'>Margin</span><span class='op'>=</span><span class='str'>&#39;margin&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t156' class='pln'>&nbsp; &nbsp; <span class='nam'>Marker</span><span class='op'>=</span><span class='str'>&#39;marker&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t157' class='pln'>&nbsp; &nbsp; <span class='nam'>RadialAxis</span><span class='op'>=</span><span class='str'>&#39;radialaxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t158' class='pln'>&nbsp; &nbsp; <span class='nam'>Stream</span><span class='op'>=</span><span class='str'>&#39;stream&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t159' class='pln'>&nbsp; &nbsp; <span class='nam'>Trace</span><span class='op'>=</span><span class='str'>&#39;trace&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t160' class='pln'>&nbsp; &nbsp; <span class='nam'>XAxis</span><span class='op'>=</span><span class='str'>&#39;xaxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t161' class='pln'>&nbsp; &nbsp; <span class='nam'>XBins</span><span class='op'>=</span><span class='str'>&#39;xbins&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t162' class='pln'>&nbsp; &nbsp; <span class='nam'>YAxis</span><span class='op'>=</span><span class='str'>&#39;yaxis&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t163' class='pln'>&nbsp; &nbsp; <span class='nam'>YBins</span><span class='op'>=</span><span class='str'>&#39;ybins&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t164' class='pln'><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t165' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t166' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t167' class='pln'><span class='str'>&nbsp; &nbsp; The sole purpose of this meta class is to properly create the __doc__</span><span class='strut'>&nbsp;</span></p>
-<p id='t168' class='pln'><span class='str'>&nbsp; &nbsp; attribute so that running help(Obj), where Obj is a subclass of PlotlyList,</span><span class='strut'>&nbsp;</span></p>
-<p id='t169' class='pln'><span class='str'>&nbsp; &nbsp; will return useful information for that object.</span><span class='strut'>&nbsp;</span></p>
-<p id='t170' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t171' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t172' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t173' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__new__</span><span class='op'>(</span><span class='nam'>mcs</span><span class='op'>,</span> <span class='nam'>name</span><span class='op'>,</span> <span class='nam'>bases</span><span class='op'>,</span> <span class='nam'>attrs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t174' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>=</span> <span class='nam'>attrs</span><span class='op'>[</span><span class='str'>&#39;__doc__&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t175' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>tab_size</span> <span class='op'>=</span> <span class='num'>4</span><span class='strut'>&nbsp;</span></p>
-<p id='t176' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>min_indent</span> <span class='op'>=</span> <span class='nam'>min</span><span class='op'>(</span><span class='op'>[</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>a</span><span class='op'>)</span> <span class='op'>-</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>b</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t177' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>a</span><span class='op'>,</span> <span class='nam'>b</span> <span class='key'>in</span> <span class='nam'>zip</span><span class='op'>(</span><span class='nam'>doc</span><span class='op'>.</span><span class='nam'>splitlines</span><span class='op'>(</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t178' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>[</span><span class='nam'>l</span><span class='op'>.</span><span class='nam'>lstrip</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t179' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='key'>for</span> <span class='nam'>l</span> <span class='key'>in</span> <span class='nam'>doc</span><span class='op'>.</span><span class='nam'>splitlines</span><span class='op'>(</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t180' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>=</span> <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='op'>[</span><span class='nam'>line</span><span class='op'>[</span><span class='nam'>min_indent</span><span class='op'>:</span><span class='op'>]</span> <span class='op'>+</span> <span class='str'>&#39;\n&#39;</span> <span class='key'>for</span> <span class='nam'>line</span> <span class='key'>in</span> <span class='nam'>doc</span><span class='op'>.</span><span class='nam'>splitlines</span><span class='op'>(</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t181' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># Add section header for method list...</span><span class='strut'>&nbsp;</span></p>
-<p id='t182' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&quot;Quick method reference:\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t183' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&quot;\t{0}.&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n\t{0}.&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t184' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>[</span><span class='str'>&quot;update(changes)&quot;</span><span class='op'>,</span> <span class='str'>&quot;strip_style()&quot;</span><span class='op'>,</span> <span class='str'>&quot;get_data()&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t185' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;to_graph_objs()&quot;</span><span class='op'>,</span> <span class='str'>&quot;validate()&quot;</span><span class='op'>,</span> <span class='str'>&quot;to_string()&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t186' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;force_clean()&quot;</span><span class='op'>]</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t187' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>attrs</span><span class='op'>[</span><span class='str'>&#39;__doc__&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>doc</span><span class='op'>.</span><span class='nam'>expandtabs</span><span class='op'>(</span><span class='nam'>tab_size</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t188' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>super</span><span class='op'>(</span><span class='nam'>ListMeta</span><span class='op'>,</span> <span class='nam'>mcs</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__new__</span><span class='op'>(</span><span class='nam'>mcs</span><span class='op'>,</span> <span class='nam'>name</span><span class='op'>,</span> <span class='nam'>bases</span><span class='op'>,</span> <span class='nam'>attrs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t189' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t190' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t191' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>DictMeta</span><span class='op'>(</span><span class='nam'>type</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t192' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A meta class for PlotlyDict class creation.</span><span class='strut'>&nbsp;</span></p>
+<p id='t167' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>ListMeta</span><span class='op'>(</span><span class='nam'>type</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t168' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A meta class for PlotlyList class creation.</span><span class='strut'>&nbsp;</span></p>
+<p id='t169' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t170' class='pln'><span class='str'>&nbsp; &nbsp; The sole purpose of this meta class is to properly create the __doc__</span><span class='strut'>&nbsp;</span></p>
+<p id='t171' class='pln'><span class='str'>&nbsp; &nbsp; attribute so that running help(Obj), where Obj is a subclass of PlotlyList,</span><span class='strut'>&nbsp;</span></p>
+<p id='t172' class='pln'><span class='str'>&nbsp; &nbsp; will return useful information for that object.</span><span class='strut'>&nbsp;</span></p>
+<p id='t173' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t174' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t175' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t176' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__new__</span><span class='op'>(</span><span class='nam'>mcs</span><span class='op'>,</span> <span class='nam'>name</span><span class='op'>,</span> <span class='nam'>bases</span><span class='op'>,</span> <span class='nam'>attrs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t177' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>=</span> <span class='nam'>attrs</span><span class='op'>[</span><span class='str'>&#39;__doc__&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t178' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>tab_size</span> <span class='op'>=</span> <span class='num'>4</span><span class='strut'>&nbsp;</span></p>
+<p id='t179' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>min_indent</span> <span class='op'>=</span> <span class='nam'>min</span><span class='op'>(</span><span class='op'>[</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>a</span><span class='op'>)</span> <span class='op'>-</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>b</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t180' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>a</span><span class='op'>,</span> <span class='nam'>b</span> <span class='key'>in</span> <span class='nam'>zip</span><span class='op'>(</span><span class='nam'>doc</span><span class='op'>.</span><span class='nam'>splitlines</span><span class='op'>(</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t181' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>[</span><span class='nam'>l</span><span class='op'>.</span><span class='nam'>lstrip</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t182' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='key'>for</span> <span class='nam'>l</span> <span class='key'>in</span> <span class='nam'>doc</span><span class='op'>.</span><span class='nam'>splitlines</span><span class='op'>(</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t183' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>=</span> <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='op'>[</span><span class='nam'>line</span><span class='op'>[</span><span class='nam'>min_indent</span><span class='op'>:</span><span class='op'>]</span> <span class='op'>+</span> <span class='str'>&#39;\n&#39;</span> <span class='key'>for</span> <span class='nam'>line</span> <span class='key'>in</span> <span class='nam'>doc</span><span class='op'>.</span><span class='nam'>splitlines</span><span class='op'>(</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t184' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># Add section header for method list...</span><span class='strut'>&nbsp;</span></p>
+<p id='t185' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&quot;Quick method reference:\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t186' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&quot;\t{0}.&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n\t{0}.&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t187' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>[</span><span class='str'>&quot;update(changes)&quot;</span><span class='op'>,</span> <span class='str'>&quot;strip_style()&quot;</span><span class='op'>,</span> <span class='str'>&quot;get_data()&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t188' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;to_graph_objs()&quot;</span><span class='op'>,</span> <span class='str'>&quot;validate()&quot;</span><span class='op'>,</span> <span class='str'>&quot;to_string()&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t189' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;force_clean()&quot;</span><span class='op'>]</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t190' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>attrs</span><span class='op'>[</span><span class='str'>&#39;__doc__&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>doc</span><span class='op'>.</span><span class='nam'>expandtabs</span><span class='op'>(</span><span class='nam'>tab_size</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t191' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>super</span><span class='op'>(</span><span class='nam'>ListMeta</span><span class='op'>,</span> <span class='nam'>mcs</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__new__</span><span class='op'>(</span><span class='nam'>mcs</span><span class='op'>,</span> <span class='nam'>name</span><span class='op'>,</span> <span class='nam'>bases</span><span class='op'>,</span> <span class='nam'>attrs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t192' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t193' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t194' class='pln'><span class='str'>&nbsp; &nbsp; The sole purpose of this meta class is to properly create the __doc__</span><span class='strut'>&nbsp;</span></p>
-<p id='t195' class='pln'><span class='str'>&nbsp; &nbsp; attribute so that running help(Obj), where Obj is a subclass of PlotlyDict,</span><span class='strut'>&nbsp;</span></p>
-<p id='t196' class='pln'><span class='str'>&nbsp; &nbsp; will return information about key-value pairs for that object.</span><span class='strut'>&nbsp;</span></p>
-<p id='t197' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t198' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t199' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__new__</span><span class='op'>(</span><span class='nam'>mcs</span><span class='op'>,</span> <span class='nam'>name</span><span class='op'>,</span> <span class='nam'>bases</span><span class='op'>,</span> <span class='nam'>attrs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t200' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>name</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t201' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># remove min indentation...</span><span class='strut'>&nbsp;</span></p>
-<p id='t202' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>=</span> <span class='nam'>attrs</span><span class='op'>[</span><span class='str'>&#39;__doc__&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t203' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_info</span> <span class='op'>=</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t204' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>line_size</span> <span class='op'>=</span> <span class='num'>76</span><span class='strut'>&nbsp;</span></p>
-<p id='t205' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>tab_size</span> <span class='op'>=</span> <span class='num'>4</span><span class='strut'>&nbsp;</span></p>
-<p id='t206' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>min_indent</span> <span class='op'>=</span> <span class='nam'>min</span><span class='op'>(</span><span class='op'>[</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>a</span><span class='op'>)</span> <span class='op'>-</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>b</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t207' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>a</span><span class='op'>,</span> <span class='nam'>b</span> <span class='key'>in</span> <span class='nam'>zip</span><span class='op'>(</span><span class='nam'>doc</span><span class='op'>.</span><span class='nam'>splitlines</span><span class='op'>(</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t208' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>[</span><span class='nam'>l</span><span class='op'>.</span><span class='nam'>lstrip</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t209' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='key'>for</span> <span class='nam'>l</span> <span class='key'>in</span> <span class='nam'>doc</span><span class='op'>.</span><span class='nam'>splitlines</span><span class='op'>(</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t210' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>=</span> <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='op'>[</span><span class='nam'>line</span><span class='op'>[</span><span class='nam'>min_indent</span><span class='op'>:</span><span class='op'>]</span> <span class='op'>+</span> <span class='str'>&#39;\n&#39;</span> <span class='key'>for</span> <span class='nam'>line</span> <span class='key'>in</span> <span class='nam'>doc</span><span class='op'>.</span><span class='nam'>splitlines</span><span class='op'>(</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t211' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># Add section header for method list...</span><span class='strut'>&nbsp;</span></p>
-<p id='t212' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&quot;Quick method reference:\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t213' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&quot;\t{0}.&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n\t{0}.&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t214' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>[</span><span class='str'>&quot;update(changes)&quot;</span><span class='op'>,</span> <span class='str'>&quot;strip_style()&quot;</span><span class='op'>,</span> <span class='str'>&quot;get_data()&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t215' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;to_graph_objs()&quot;</span><span class='op'>,</span> <span class='str'>&quot;validate()&quot;</span><span class='op'>,</span> <span class='str'>&quot;to_string()&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t216' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;force_clean()&quot;</span><span class='op'>]</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t217' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># Add section header</span><span class='strut'>&nbsp;</span></p>
-<p id='t218' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t219' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&quot;Valid keys:\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t220' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># Add each key one-by-one and format</span><span class='strut'>&nbsp;</span></p>
-<p id='t221' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width1</span> <span class='op'>=</span> <span class='nam'>line_size</span><span class='op'>-</span><span class='nam'>tab_size</span><span class='strut'>&nbsp;</span></p>
-<p id='t222' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width2</span> <span class='op'>=</span> <span class='nam'>line_size</span><span class='op'>-</span><span class='num'>2</span><span class='op'>*</span><span class='nam'>tab_size</span><span class='strut'>&nbsp;</span></p>
-<p id='t223' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width3</span> <span class='op'>=</span> <span class='nam'>line_size</span><span class='op'>-</span><span class='num'>3</span><span class='op'>*</span><span class='nam'>tab_size</span><span class='strut'>&nbsp;</span></p>
-<p id='t224' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>undocumented</span> <span class='op'>=</span> <span class='str'>&quot;Aw, snap! Undocumented!&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t225' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>obj_info</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t226' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># main portion of documentation</span><span class='strut'>&nbsp;</span></p>
-<p id='t227' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t228' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>required</span> <span class='op'>=</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;required&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t229' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t230' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>required</span> <span class='op'>=</span> <span class='nam'>undocumented</span><span class='strut'>&nbsp;</span></p>
-<p id='t231' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t232' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t233' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>typ</span> <span class='op'>=</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t234' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t235' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>typ</span> <span class='op'>=</span> <span class='nam'>undocumented</span><span class='strut'>&nbsp;</span></p>
-<p id='t236' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t237' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t238' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;val_types&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t239' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>typ</span> <span class='op'>==</span> <span class='str'>&#39;object&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t240' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='str'>&quot;{0} object | &quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span><span class='op'>+</span><span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
-<p id='t241' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span><span class='strut'>&nbsp;</span></p>
-<p id='t242' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t243' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='nam'>undocumented</span><span class='strut'>&nbsp;</span></p>
-<p id='t244' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t245' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>descr</span> <span class='op'>=</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;description&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t246' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t247' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>descr</span> <span class='op'>=</span> <span class='nam'>undocumented</span><span class='strut'>&nbsp;</span></p>
-<p id='t248' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>str_1</span> <span class='op'>=</span> <span class='str'>&quot;{0} [required={1}] (value={2})&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t249' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>required</span><span class='op'>,</span> <span class='nam'>val_types</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t250' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&quot;streamable&quot;</span> <span class='key'>in</span> <span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='key'>and</span> <span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&quot;streamable&quot;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t251' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>str_1</span> <span class='op'>+=</span> <span class='str'>&quot; (streamable)&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t252' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>str_1</span> <span class='op'>+=</span> <span class='str'>&quot;:\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t253' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>str_1</span> <span class='op'>=</span> <span class='str'>&quot;\t&quot;</span> <span class='op'>+</span> <span class='str'>&quot;\n\t&quot;</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>textwrap</span><span class='op'>.</span><span class='nam'>wrap</span><span class='op'>(</span><span class='nam'>str_1</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t254' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>width</span><span class='op'>=</span><span class='nam'>width1</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t255' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>str_2</span> <span class='op'>=</span> <span class='str'>&quot;\t\t&quot;</span> <span class='op'>+</span> <span class='str'>&quot;\n\t\t&quot;</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>textwrap</span><span class='op'>.</span><span class='nam'>wrap</span><span class='op'>(</span><span class='nam'>descr</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t256' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>width</span><span class='op'>=</span><span class='nam'>width2</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t257' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='nam'>str_1</span> <span class='op'>+</span> <span class='nam'>str_2</span><span class='strut'>&nbsp;</span></p>
-<p id='t258' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># if a user can run help on this value, tell them!</span><span class='strut'>&nbsp;</span></p>
-<p id='t259' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>typ</span> <span class='op'>==</span> <span class='str'>&quot;object&quot;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t260' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&quot;\n\t\tFor more, run `help(plotly.graph_objs.{0&quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
-<p id='t261' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;})`\n&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t262' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># if example usage exists, tell them!</span><span class='strut'>&nbsp;</span></p>
-<p id='t263' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;examples&#39;</span> <span class='key'>in</span> <span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t264' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ex</span> <span class='op'>=</span> <span class='str'>&quot;\n\t\tExamples:\n&quot;</span> <span class='op'>+</span> <span class='str'>&quot;\t\t\t&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t265' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ex</span> <span class='op'>+=</span> <span class='str'>&quot;\n\t\t\t&quot;</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t266' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>textwrap</span><span class='op'>.</span><span class='nam'>wrap</span><span class='op'>(</span><span class='nam'>str</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;examples&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t267' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width</span><span class='op'>=</span><span class='nam'>width3</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t268' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='nam'>ex</span><span class='strut'>&nbsp;</span></p>
-<p id='t269' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;code&#39;</span> <span class='key'>in</span> <span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t270' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>code</span> <span class='op'>=</span> <span class='str'>&quot;\n\t\tCode snippet:&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t271' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>code</span> <span class='op'>+=</span> <span class='str'>&quot;\n\t\t\t&gt;&gt;&gt;&quot;</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t272' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>str</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;code&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>split</span><span class='op'>(</span><span class='str'>&#39;&gt;&gt;&gt;&#39;</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t273' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='nam'>code</span><span class='strut'>&nbsp;</span></p>
-<p id='t274' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&#39;\n&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t275' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>attrs</span><span class='op'>[</span><span class='str'>&#39;__doc__&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>doc</span><span class='op'>.</span><span class='nam'>expandtabs</span><span class='op'>(</span><span class='nam'>tab_size</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t276' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>super</span><span class='op'>(</span><span class='nam'>DictMeta</span><span class='op'>,</span> <span class='nam'>mcs</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__new__</span><span class='op'>(</span><span class='nam'>mcs</span><span class='op'>,</span> <span class='nam'>name</span><span class='op'>,</span> <span class='nam'>bases</span><span class='op'>,</span> <span class='nam'>attrs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t277' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t278' class='stm run hide_run'><span class='op'>@</span><span class='nam'>six</span><span class='op'>.</span><span class='nam'>add_metaclass</span><span class='op'>(</span><span class='nam'>ListMeta</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t279' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>PlotlyList</span><span class='op'>(</span><span class='nam'>list</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t280' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A container for PlotlyDicts, inherits from standard list.</span><span class='strut'>&nbsp;</span></p>
-<p id='t281' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t282' class='pln'><span class='str'>&nbsp; &nbsp; Plotly uses lists and dicts as collections to hold information about a</span><span class='strut'>&nbsp;</span></p>
-<p id='t283' class='pln'><span class='str'>&nbsp; &nbsp; figure. This container is simply a list that understands some plotly</span><span class='strut'>&nbsp;</span></p>
-<p id='t284' class='pln'><span class='str'>&nbsp; &nbsp; language and apes the methods in a PlotlyDict, passing them on to its</span><span class='strut'>&nbsp;</span></p>
-<p id='t285' class='pln'><span class='str'>&nbsp; &nbsp; constituents.</span><span class='strut'>&nbsp;</span></p>
-<p id='t286' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t287' class='pln'><span class='str'>&nbsp; &nbsp; It can be initialized like any other list so long as the entries are all</span><span class='strut'>&nbsp;</span></p>
-<p id='t288' class='pln'><span class='str'>&nbsp; &nbsp; PlotlyDict objects or subclasses thereof.</span><span class='strut'>&nbsp;</span></p>
+<p id='t194' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>DictMeta</span><span class='op'>(</span><span class='nam'>type</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t195' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A meta class for PlotlyDict class creation.</span><span class='strut'>&nbsp;</span></p>
+<p id='t196' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t197' class='pln'><span class='str'>&nbsp; &nbsp; The sole purpose of this meta class is to properly create the __doc__</span><span class='strut'>&nbsp;</span></p>
+<p id='t198' class='pln'><span class='str'>&nbsp; &nbsp; attribute so that running help(Obj), where Obj is a subclass of PlotlyDict,</span><span class='strut'>&nbsp;</span></p>
+<p id='t199' class='pln'><span class='str'>&nbsp; &nbsp; will return information about key-value pairs for that object.</span><span class='strut'>&nbsp;</span></p>
+<p id='t200' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t201' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t202' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__new__</span><span class='op'>(</span><span class='nam'>mcs</span><span class='op'>,</span> <span class='nam'>name</span><span class='op'>,</span> <span class='nam'>bases</span><span class='op'>,</span> <span class='nam'>attrs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t203' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>name</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t204' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># remove min indentation...</span><span class='strut'>&nbsp;</span></p>
+<p id='t205' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>=</span> <span class='nam'>attrs</span><span class='op'>[</span><span class='str'>&#39;__doc__&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t206' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_info</span> <span class='op'>=</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t207' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>line_size</span> <span class='op'>=</span> <span class='num'>76</span><span class='strut'>&nbsp;</span></p>
+<p id='t208' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>tab_size</span> <span class='op'>=</span> <span class='num'>4</span><span class='strut'>&nbsp;</span></p>
+<p id='t209' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>min_indent</span> <span class='op'>=</span> <span class='nam'>min</span><span class='op'>(</span><span class='op'>[</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>a</span><span class='op'>)</span> <span class='op'>-</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>b</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t210' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>a</span><span class='op'>,</span> <span class='nam'>b</span> <span class='key'>in</span> <span class='nam'>zip</span><span class='op'>(</span><span class='nam'>doc</span><span class='op'>.</span><span class='nam'>splitlines</span><span class='op'>(</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t211' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>[</span><span class='nam'>l</span><span class='op'>.</span><span class='nam'>lstrip</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t212' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='key'>for</span> <span class='nam'>l</span> <span class='key'>in</span> <span class='nam'>doc</span><span class='op'>.</span><span class='nam'>splitlines</span><span class='op'>(</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t213' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>=</span> <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='op'>[</span><span class='nam'>line</span><span class='op'>[</span><span class='nam'>min_indent</span><span class='op'>:</span><span class='op'>]</span> <span class='op'>+</span> <span class='str'>&#39;\n&#39;</span> <span class='key'>for</span> <span class='nam'>line</span> <span class='key'>in</span> <span class='nam'>doc</span><span class='op'>.</span><span class='nam'>splitlines</span><span class='op'>(</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t214' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># Add section header for method list...</span><span class='strut'>&nbsp;</span></p>
+<p id='t215' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&quot;Quick method reference:\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t216' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&quot;\t{0}.&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n\t{0}.&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t217' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>[</span><span class='str'>&quot;update(changes)&quot;</span><span class='op'>,</span> <span class='str'>&quot;strip_style()&quot;</span><span class='op'>,</span> <span class='str'>&quot;get_data()&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t218' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;to_graph_objs()&quot;</span><span class='op'>,</span> <span class='str'>&quot;validate()&quot;</span><span class='op'>,</span> <span class='str'>&quot;to_string()&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t219' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;force_clean()&quot;</span><span class='op'>]</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t220' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># Add section header</span><span class='strut'>&nbsp;</span></p>
+<p id='t221' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t222' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&quot;Valid keys:\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t223' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># Add each key one-by-one and format</span><span class='strut'>&nbsp;</span></p>
+<p id='t224' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width1</span> <span class='op'>=</span> <span class='nam'>line_size</span><span class='op'>-</span><span class='nam'>tab_size</span><span class='strut'>&nbsp;</span></p>
+<p id='t225' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width2</span> <span class='op'>=</span> <span class='nam'>line_size</span><span class='op'>-</span><span class='num'>2</span><span class='op'>*</span><span class='nam'>tab_size</span><span class='strut'>&nbsp;</span></p>
+<p id='t226' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width3</span> <span class='op'>=</span> <span class='nam'>line_size</span><span class='op'>-</span><span class='num'>3</span><span class='op'>*</span><span class='nam'>tab_size</span><span class='strut'>&nbsp;</span></p>
+<p id='t227' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>undocumented</span> <span class='op'>=</span> <span class='str'>&quot;Aw, snap! Undocumented!&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t228' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>obj_info</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t229' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># main portion of documentation</span><span class='strut'>&nbsp;</span></p>
+<p id='t230' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t231' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>required</span> <span class='op'>=</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;required&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t232' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t233' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>required</span> <span class='op'>=</span> <span class='nam'>undocumented</span><span class='strut'>&nbsp;</span></p>
+<p id='t234' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t235' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t236' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>typ</span> <span class='op'>=</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t237' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t238' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>typ</span> <span class='op'>=</span> <span class='nam'>undocumented</span><span class='strut'>&nbsp;</span></p>
+<p id='t239' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t240' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t241' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;val_types&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t242' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>typ</span> <span class='op'>==</span> <span class='str'>&#39;object&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t243' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='str'>&quot;{0} object | &quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span><span class='op'>+</span><span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
+<p id='t244' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span><span class='strut'>&nbsp;</span></p>
+<p id='t245' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t246' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='nam'>undocumented</span><span class='strut'>&nbsp;</span></p>
+<p id='t247' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t248' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>descr</span> <span class='op'>=</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;description&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t249' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t250' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>descr</span> <span class='op'>=</span> <span class='nam'>undocumented</span><span class='strut'>&nbsp;</span></p>
+<p id='t251' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>str_1</span> <span class='op'>=</span> <span class='str'>&quot;{0} [required={1}] (value={2})&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t252' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>required</span><span class='op'>,</span> <span class='nam'>val_types</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t253' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&quot;streamable&quot;</span> <span class='key'>in</span> <span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='key'>and</span> <span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&quot;streamable&quot;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t254' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>str_1</span> <span class='op'>+=</span> <span class='str'>&quot; (streamable)&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t255' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>str_1</span> <span class='op'>+=</span> <span class='str'>&quot;:\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t256' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>str_1</span> <span class='op'>=</span> <span class='str'>&quot;\t&quot;</span> <span class='op'>+</span> <span class='str'>&quot;\n\t&quot;</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>textwrap</span><span class='op'>.</span><span class='nam'>wrap</span><span class='op'>(</span><span class='nam'>str_1</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t257' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>width</span><span class='op'>=</span><span class='nam'>width1</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t258' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>str_2</span> <span class='op'>=</span> <span class='str'>&quot;\t\t&quot;</span> <span class='op'>+</span> <span class='str'>&quot;\n\t\t&quot;</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>textwrap</span><span class='op'>.</span><span class='nam'>wrap</span><span class='op'>(</span><span class='nam'>descr</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t259' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>width</span><span class='op'>=</span><span class='nam'>width2</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t260' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='nam'>str_1</span> <span class='op'>+</span> <span class='nam'>str_2</span><span class='strut'>&nbsp;</span></p>
+<p id='t261' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># if a user can run help on this value, tell them!</span><span class='strut'>&nbsp;</span></p>
+<p id='t262' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>typ</span> <span class='op'>==</span> <span class='str'>&quot;object&quot;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t263' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&quot;\n\t\tFor more, run `help(plotly.graph_objs.{0&quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
+<p id='t264' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;})`\n&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t265' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># if example usage exists, tell them!</span><span class='strut'>&nbsp;</span></p>
+<p id='t266' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;examples&#39;</span> <span class='key'>in</span> <span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t267' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ex</span> <span class='op'>=</span> <span class='str'>&quot;\n\t\tExamples:\n&quot;</span> <span class='op'>+</span> <span class='str'>&quot;\t\t\t&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t268' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ex</span> <span class='op'>+=</span> <span class='str'>&quot;\n\t\t\t&quot;</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t269' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>textwrap</span><span class='op'>.</span><span class='nam'>wrap</span><span class='op'>(</span><span class='nam'>str</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;examples&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t270' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width</span><span class='op'>=</span><span class='nam'>width3</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t271' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='nam'>ex</span><span class='strut'>&nbsp;</span></p>
+<p id='t272' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;code&#39;</span> <span class='key'>in</span> <span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t273' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>code</span> <span class='op'>=</span> <span class='str'>&quot;\n\t\tCode snippet:&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t274' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>code</span> <span class='op'>+=</span> <span class='str'>&quot;\n\t\t\t&gt;&gt;&gt;&quot;</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t275' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>str</span><span class='op'>(</span><span class='nam'>obj_info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;code&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>split</span><span class='op'>(</span><span class='str'>&#39;&gt;&gt;&gt;&#39;</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>+</span> <span class='str'>&quot;\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t276' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='nam'>code</span><span class='strut'>&nbsp;</span></p>
+<p id='t277' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>doc</span> <span class='op'>+=</span> <span class='str'>&#39;\n&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t278' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>attrs</span><span class='op'>[</span><span class='str'>&#39;__doc__&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>doc</span><span class='op'>.</span><span class='nam'>expandtabs</span><span class='op'>(</span><span class='nam'>tab_size</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t279' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>super</span><span class='op'>(</span><span class='nam'>DictMeta</span><span class='op'>,</span> <span class='nam'>mcs</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__new__</span><span class='op'>(</span><span class='nam'>mcs</span><span class='op'>,</span> <span class='nam'>name</span><span class='op'>,</span> <span class='nam'>bases</span><span class='op'>,</span> <span class='nam'>attrs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t280' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t281' class='stm run hide_run'><span class='op'>@</span><span class='nam'>six</span><span class='op'>.</span><span class='nam'>add_metaclass</span><span class='op'>(</span><span class='nam'>ListMeta</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t282' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>PlotlyList</span><span class='op'>(</span><span class='nam'>list</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t283' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A container for PlotlyDicts, inherits from standard list.</span><span class='strut'>&nbsp;</span></p>
+<p id='t284' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t285' class='pln'><span class='str'>&nbsp; &nbsp; Plotly uses lists and dicts as collections to hold information about a</span><span class='strut'>&nbsp;</span></p>
+<p id='t286' class='pln'><span class='str'>&nbsp; &nbsp; figure. This container is simply a list that understands some plotly</span><span class='strut'>&nbsp;</span></p>
+<p id='t287' class='pln'><span class='str'>&nbsp; &nbsp; language and apes the methods in a PlotlyDict, passing them on to its</span><span class='strut'>&nbsp;</span></p>
+<p id='t288' class='pln'><span class='str'>&nbsp; &nbsp; constituents.</span><span class='strut'>&nbsp;</span></p>
 <p id='t289' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t290' class='pln'><span class='str'>&nbsp; &nbsp; Any available methods that hold for a list object hold for a PlotlyList.</span><span class='strut'>&nbsp;</span></p>
-<p id='t291' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t292' class='pln'><span class='str'>&nbsp; &nbsp; Validation checking is preformed upon instantiation.</span><span class='strut'>&nbsp;</span></p>
-<p id='t293' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t294' class='pln'><span class='str'>&nbsp; &nbsp; Valid entry types: empty PlotlyDict or dict only.</span><span class='strut'>&nbsp;</span></p>
-<p id='t295' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t290' class='pln'><span class='str'>&nbsp; &nbsp; It can be initialized like any other list so long as the entries are all</span><span class='strut'>&nbsp;</span></p>
+<p id='t291' class='pln'><span class='str'>&nbsp; &nbsp; PlotlyDict objects or subclasses thereof.</span><span class='strut'>&nbsp;</span></p>
+<p id='t292' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t293' class='pln'><span class='str'>&nbsp; &nbsp; Any available methods that hold for a list object hold for a PlotlyList.</span><span class='strut'>&nbsp;</span></p>
+<p id='t294' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t295' class='pln'><span class='str'>&nbsp; &nbsp; Validation checking is preformed upon instantiation.</span><span class='strut'>&nbsp;</span></p>
 <p id='t296' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t297' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t297' class='pln'><span class='str'>&nbsp; &nbsp; Valid entry types: empty PlotlyDict or dict only.</span><span class='strut'>&nbsp;</span></p>
 <p id='t298' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t299' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t300' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>PlotlyList</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__init__</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t301' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>args</span> <span class='key'>and</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>args</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t302' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyListEntryError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t303' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t304' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span><span class='op'>=</span><span class='num'>0</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t305' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='str'>&quot;Just like a `list`, `{name}` must be instantiated with &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t306' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;a *single* collection.\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t307' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;In other words these are OK:\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t308' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&gt;&gt;&gt; {name}()\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t309' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&gt;&gt;&gt; {name}([])\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t310' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&gt;&gt;&gt; {name}([dict()])\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t311' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&gt;&gt;&gt; {name}([dict(), dict()])\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t312' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;However, these don&#39;t make sense:\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t313' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&gt;&gt;&gt; {name}(dict())\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t314' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&gt;&gt;&gt; {name}(dict(), dict())&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t315' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t316' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t317' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t318' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span> <span class='op'>==</span> <span class='str'>&#39;PlotlyList&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t319' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;\nThe PlotlyList class is a base class of &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t320' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;list-like graph_objs.\nIt is not meant to be a &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t321' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;user interface.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t322' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t323' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t324' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Change any nested collections to subclasses of PlotlyDict/List.</span><span class='strut'>&nbsp;</span></p>
+<p id='t299' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t300' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t301' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t302' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t303' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>PlotlyList</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__init__</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t304' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>args</span> <span class='key'>and</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>args</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t305' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyListEntryError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t306' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t307' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span><span class='op'>=</span><span class='num'>0</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t308' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='str'>&quot;Just like a `list`, `{name}` must be instantiated with &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t309' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;a *single* collection.\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t310' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;In other words these are OK:\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t311' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&gt;&gt;&gt; {name}()\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t312' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&gt;&gt;&gt; {name}([])\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t313' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&gt;&gt;&gt; {name}([dict()])\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t314' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&gt;&gt;&gt; {name}([dict(), dict()])\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t315' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;However, these don&#39;t make sense:\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t316' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&gt;&gt;&gt; {name}(dict())\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t317' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&gt;&gt;&gt; {name}(dict(), dict())&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t318' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t319' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t320' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t321' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span> <span class='op'>==</span> <span class='str'>&#39;PlotlyList&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t322' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;\nThe PlotlyList class is a base class of &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t323' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;list-like graph_objs.\nIt is not meant to be a &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t324' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;user interface.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
 <p id='t325' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t326' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Procedure:</span><span class='strut'>&nbsp;</span></p>
-<p id='t327' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 1. Attempt to convert all entries to a subclass of PlotlyDict.</span><span class='strut'>&nbsp;</span></p>
-<p id='t328' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2. Call `to_graph_objects` on each of these entries.</span><span class='strut'>&nbsp;</span></p>
-<p id='t329' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t330' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t331' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t332' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t333' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t334' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>entry</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t335' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='op'>(</span><span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span><span class='op'>)</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t336' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_to_error_path</span><span class='op'>(</span><span class='nam'>index</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t337' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t338' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span>&nbsp; <span class='com'># re-raise current exception</span><span class='strut'>&nbsp;</span></p>
-<p id='t339' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t340' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyListEntryError</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t341' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span><span class='op'>=</span><span class='nam'>index</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t342' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>entry</span><span class='op'>=</span><span class='nam'>entry</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t343' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t344' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t345' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>update</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>changes</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t346' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Update current list with changed_list, which must be iterable.</span><span class='strut'>&nbsp;</span></p>
-<p id='t347' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The &#39;changes&#39; should be a list of dictionaries, however,</span><span class='strut'>&nbsp;</span></p>
-<p id='t348' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; it is permitted to be a single dict object.</span><span class='strut'>&nbsp;</span></p>
-<p id='t349' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t350' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t351' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>changes</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t352' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>changes</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>changes</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t353' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t354' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span> <span class='key'>in</span> <span class='nam'>range</span><span class='op'>(</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t355' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t356' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>changes</span><span class='op'>[</span><span class='nam'>index</span> <span class='op'>%</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>changes</span><span class='op'>)</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t357' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>ZeroDivisionError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t358' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t359' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t360' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>strip_style</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t361' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Strip style from the current representation.</span><span class='strut'>&nbsp;</span></p>
-<p id='t362' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t363' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; All PlotlyDicts and PlotlyLists are guaranteed to survive the</span><span class='strut'>&nbsp;</span></p>
-<p id='t364' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; stripping process, though they made be left empty. This is allowable.</span><span class='strut'>&nbsp;</span></p>
-<p id='t365' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t366' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Keys that will be stripped in this process are tagged with</span><span class='strut'>&nbsp;</span></p>
-<p id='t367' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; `&#39;type&#39;: &#39;style&#39;` in the INFO dictionary listed in graph_objs_meta.py.</span><span class='strut'>&nbsp;</span></p>
-<p id='t368' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t369' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This process first attempts to convert nested collections from dicts</span><span class='strut'>&nbsp;</span></p>
-<p id='t370' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; or lists to subclasses of PlotlyList/PlotlyDict. This process forces</span><span class='strut'>&nbsp;</span></p>
-<p id='t371' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; a validation, which may throw exceptions.</span><span class='strut'>&nbsp;</span></p>
-<p id='t372' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t373' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Then, each of these objects call `strip_style` on themselves and so</span><span class='strut'>&nbsp;</span></p>
-<p id='t374' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; on, recursively until the entire structure has been validated and</span><span class='strut'>&nbsp;</span></p>
-<p id='t375' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; stripped.</span><span class='strut'>&nbsp;</span></p>
-<p id='t376' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t377' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t378' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t379' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>plotly_dict</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t380' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plotly_dict</span><span class='op'>.</span><span class='nam'>strip_style</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t381' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t382' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>get_data</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t383' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns the JSON for the plot with non-data elements stripped.&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t384' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t385' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>l</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t386' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>_plotlydict</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t387' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>l</span> <span class='op'>+=</span> <span class='op'>[</span><span class='nam'>_plotlydict</span><span class='op'>.</span><span class='nam'>get_data</span><span class='op'>(</span><span class='op'>)</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t388' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_indicies</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>index</span> <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>item</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t389' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>item</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t390' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_ct</span> <span class='op'>=</span> <span class='num'>0</span><span class='strut'>&nbsp;</span></p>
-<p id='t391' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span> <span class='key'>in</span> <span class='nam'>del_indicies</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t392' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span> <span class='op'>-</span> <span class='nam'>del_ct</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t393' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_ct</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
-<p id='t394' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>l</span><span class='strut'>&nbsp;</span></p>
-<p id='t395' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t396' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>validate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t397' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Recursively check the validity of the entries in a PlotlyList.</span><span class='strut'>&nbsp;</span></p>
-<p id='t398' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t399' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; PlotlyList may only contain suclasses of PlotlyDict, or dictionary-like</span><span class='strut'>&nbsp;</span></p>
-<p id='t400' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; objects that can be re-instantiated as subclasses of PlotlyDict.</span><span class='strut'>&nbsp;</span></p>
-<p id='t401' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t402' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The validation process first requires that all nested collections be</span><span class='strut'>&nbsp;</span></p>
-<p id='t403' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; converted to the appropriate subclass of PlotlyDict/PlotlyList. Then,</span><span class='strut'>&nbsp;</span></p>
-<p id='t404' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; each of these objects call `validate` and so on, recursively,</span><span class='strut'>&nbsp;</span></p>
-<p id='t405' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; until the entire list has been validated.</span><span class='strut'>&nbsp;</span></p>
-<p id='t406' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t407' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t408' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span>&nbsp; <span class='com'># change everything to PlotlyList/Dict objects</span><span class='strut'>&nbsp;</span></p>
-<p id='t409' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t410' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t411' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t412' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t413' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
-<p id='t414' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t415' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t416' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t417' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>entry</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t418' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t419' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_to_error_path</span><span class='op'>(</span><span class='nam'>index</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t420' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t421' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
-<p id='t422' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t423' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span><span class='op'>(</span>&nbsp; <span class='com'># TODO!!!</span><span class='strut'>&nbsp;</span></p>
-<p id='t424' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>message</span><span class='op'>=</span><span class='str'>&quot;uh-oh, this error shouldn&#39;t have happenend.&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t425' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plain_message</span><span class='op'>=</span><span class='str'>&quot;uh-oh, this error shouldn&#39;t have happenend.&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t426' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>path</span><span class='op'>=</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t427' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t428' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t429' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>level</span><span class='op'>=</span><span class='num'>0</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='num'>4</span><span class='op'>,</span> <span class='nam'>eol</span><span class='op'>=</span><span class='str'>&#39;\n&#39;</span><span class='op'>,</span> <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='nam'>max_chars</span><span class='op'>=</span><span class='num'>80</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t430' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns a formatted string showing graph_obj constructors.</span><span class='strut'>&nbsp;</span></p>
-<p id='t431' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t432' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t433' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t434' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; print obj.to_string()</span><span class='strut'>&nbsp;</span></p>
-<p id='t435' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t436' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t437' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; level (default = 0) -- set number of indentations to start with</span><span class='strut'>&nbsp;</span></p>
-<p id='t438' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; indent (default = 4) -- set indentation amount</span><span class='strut'>&nbsp;</span></p>
-<p id='t439' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; eol (default = &#39;\n&#39;) -- set end of line character(s)</span><span class='strut'>&nbsp;</span></p>
-<p id='t440' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; pretty (default = True) -- curtail long list output with a &#39;...&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t441' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; max_chars (default = 80) -- set max characters per line</span><span class='strut'>&nbsp;</span></p>
-<p id='t442' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t443' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t444' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t445' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t446' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='str'>&quot;{name}()&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t447' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>=</span> <span class='str'>&quot;{name}([{eol}{indent}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t448' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t449' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t450' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>level</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t451' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t452' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>entry</span><span class='op'>.</span><span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>=</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t453' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='nam'>indent</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t454' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t455' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>pretty</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t456' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>max_chars</span><span class='op'>=</span><span class='nam'>max_chars</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t457' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>index</span> <span class='op'>&lt;</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span> <span class='op'>-</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t458' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;,{eol}{indent}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t459' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t460' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>level</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t461' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;{eol}{indent}])&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='nam'>level</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t462' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>string</span><span class='strut'>&nbsp;</span></p>
-<p id='t463' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t464' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>get_ordered</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t465' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t466' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t467' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t468' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t469' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_note</span><span class='op'>(</span><span class='str'>&quot;Could not order list because it could not be &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t470' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;converted to a valid graph object.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t471' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t472' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
-<p id='t473' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_list</span> <span class='op'>=</span> <span class='op'>[</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t474' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t475' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_list</span> <span class='op'>+=</span> <span class='op'>[</span><span class='nam'>entry</span><span class='op'>.</span><span class='nam'>get_ordered</span><span class='op'>(</span><span class='op'>)</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t476' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>ordered_list</span><span class='strut'>&nbsp;</span></p>
-<p id='t477' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t326' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t327' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Change any nested collections to subclasses of PlotlyDict/List.</span><span class='strut'>&nbsp;</span></p>
+<p id='t328' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t329' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Procedure:</span><span class='strut'>&nbsp;</span></p>
+<p id='t330' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 1. Attempt to convert all entries to a subclass of PlotlyDict.</span><span class='strut'>&nbsp;</span></p>
+<p id='t331' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2. Call `to_graph_objects` on each of these entries.</span><span class='strut'>&nbsp;</span></p>
+<p id='t332' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t333' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t334' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t335' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t336' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t337' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>entry</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t338' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='op'>(</span><span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span><span class='op'>)</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t339' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_to_error_path</span><span class='op'>(</span><span class='nam'>index</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t340' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t341' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span>&nbsp; <span class='com'># re-raise current exception</span><span class='strut'>&nbsp;</span></p>
+<p id='t342' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t343' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyListEntryError</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t344' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span><span class='op'>=</span><span class='nam'>index</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t345' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>entry</span><span class='op'>=</span><span class='nam'>entry</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t346' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t347' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t348' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>update</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>changes</span><span class='op'>,</span> <span class='nam'>make_copies</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t349' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Update current list with changed_list, which must be iterable.</span><span class='strut'>&nbsp;</span></p>
+<p id='t350' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The &#39;changes&#39; should be a list of dictionaries, however,</span><span class='strut'>&nbsp;</span></p>
+<p id='t351' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; it is permitted to be a single dict object.</span><span class='strut'>&nbsp;</span></p>
+<p id='t352' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t353' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Because mutable objects contain references to their values, updating</span><span class='strut'>&nbsp;</span></p>
+<p id='t354' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; multiple items in a list will cause the items to all reference the same</span><span class='strut'>&nbsp;</span></p>
+<p id='t355' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; original set of objects. To change this behavior add</span><span class='strut'>&nbsp;</span></p>
+<p id='t356' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; `make_copies=True` which makes deep copies of the update items and</span><span class='strut'>&nbsp;</span></p>
+<p id='t357' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; therefore break references. </span><span class='strut'>&nbsp;</span></p>
+<p id='t358' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t359' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t360' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>changes</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t361' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>changes</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>changes</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t362' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t363' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span> <span class='key'>in</span> <span class='nam'>range</span><span class='op'>(</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t364' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t365' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>update</span> <span class='op'>=</span> <span class='nam'>changes</span><span class='op'>[</span><span class='nam'>index</span> <span class='op'>%</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>changes</span><span class='op'>)</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t366' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>ZeroDivisionError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t367' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t368' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t369' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>make_copies</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t370' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>copy</span><span class='op'>.</span><span class='nam'>deepcopy</span><span class='op'>(</span><span class='nam'>update</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t371' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t372' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>update</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t373' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t374' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t375' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>strip_style</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t376' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Strip style from the current representation.</span><span class='strut'>&nbsp;</span></p>
+<p id='t377' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t378' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; All PlotlyDicts and PlotlyLists are guaranteed to survive the</span><span class='strut'>&nbsp;</span></p>
+<p id='t379' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; stripping process, though they made be left empty. This is allowable.</span><span class='strut'>&nbsp;</span></p>
+<p id='t380' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t381' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Keys that will be stripped in this process are tagged with</span><span class='strut'>&nbsp;</span></p>
+<p id='t382' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; `&#39;type&#39;: &#39;style&#39;` in the INFO dictionary listed in graph_objs_meta.py.</span><span class='strut'>&nbsp;</span></p>
+<p id='t383' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t384' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This process first attempts to convert nested collections from dicts</span><span class='strut'>&nbsp;</span></p>
+<p id='t385' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; or lists to subclasses of PlotlyList/PlotlyDict. This process forces</span><span class='strut'>&nbsp;</span></p>
+<p id='t386' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; a validation, which may throw exceptions.</span><span class='strut'>&nbsp;</span></p>
+<p id='t387' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t388' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Then, each of these objects call `strip_style` on themselves and so</span><span class='strut'>&nbsp;</span></p>
+<p id='t389' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; on, recursively until the entire structure has been validated and</span><span class='strut'>&nbsp;</span></p>
+<p id='t390' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; stripped.</span><span class='strut'>&nbsp;</span></p>
+<p id='t391' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t392' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t393' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t394' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>plotly_dict</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t395' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plotly_dict</span><span class='op'>.</span><span class='nam'>strip_style</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t396' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t397' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>get_data</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t398' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns the JSON for the plot with non-data elements stripped.&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t399' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t400' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>l</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t401' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>_plotlydict</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t402' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>l</span> <span class='op'>+=</span> <span class='op'>[</span><span class='nam'>_plotlydict</span><span class='op'>.</span><span class='nam'>get_data</span><span class='op'>(</span><span class='op'>)</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t403' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_indicies</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>index</span> <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>item</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t404' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>item</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t405' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_ct</span> <span class='op'>=</span> <span class='num'>0</span><span class='strut'>&nbsp;</span></p>
+<p id='t406' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span> <span class='key'>in</span> <span class='nam'>del_indicies</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t407' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span> <span class='op'>-</span> <span class='nam'>del_ct</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t408' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_ct</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
+<p id='t409' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>l</span><span class='strut'>&nbsp;</span></p>
+<p id='t410' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t411' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>validate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t412' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Recursively check the validity of the entries in a PlotlyList.</span><span class='strut'>&nbsp;</span></p>
+<p id='t413' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t414' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; PlotlyList may only contain suclasses of PlotlyDict, or dictionary-like</span><span class='strut'>&nbsp;</span></p>
+<p id='t415' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; objects that can be re-instantiated as subclasses of PlotlyDict.</span><span class='strut'>&nbsp;</span></p>
+<p id='t416' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t417' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The validation process first requires that all nested collections be</span><span class='strut'>&nbsp;</span></p>
+<p id='t418' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; converted to the appropriate subclass of PlotlyDict/PlotlyList. Then,</span><span class='strut'>&nbsp;</span></p>
+<p id='t419' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; each of these objects call `validate` and so on, recursively,</span><span class='strut'>&nbsp;</span></p>
+<p id='t420' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; until the entire list has been validated.</span><span class='strut'>&nbsp;</span></p>
+<p id='t421' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t422' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t423' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span>&nbsp; <span class='com'># change everything to PlotlyList/Dict objects</span><span class='strut'>&nbsp;</span></p>
+<p id='t424' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t425' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t426' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t427' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t428' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
+<p id='t429' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t430' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t431' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t432' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>entry</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t433' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t434' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_to_error_path</span><span class='op'>(</span><span class='nam'>index</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t435' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t436' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
+<p id='t437' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t438' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span><span class='op'>(</span>&nbsp; <span class='com'># TODO!!!</span><span class='strut'>&nbsp;</span></p>
+<p id='t439' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>message</span><span class='op'>=</span><span class='str'>&quot;uh-oh, this error shouldn&#39;t have happenend.&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t440' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plain_message</span><span class='op'>=</span><span class='str'>&quot;uh-oh, this error shouldn&#39;t have happenend.&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t441' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>path</span><span class='op'>=</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t442' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t443' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t444' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>level</span><span class='op'>=</span><span class='num'>0</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='num'>4</span><span class='op'>,</span> <span class='nam'>eol</span><span class='op'>=</span><span class='str'>&#39;\n&#39;</span><span class='op'>,</span> <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='nam'>max_chars</span><span class='op'>=</span><span class='num'>80</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t445' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns a formatted string showing graph_obj constructors.</span><span class='strut'>&nbsp;</span></p>
+<p id='t446' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t447' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t448' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t449' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; print obj.to_string()</span><span class='strut'>&nbsp;</span></p>
+<p id='t450' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t451' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t452' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; level (default = 0) -- set number of indentations to start with</span><span class='strut'>&nbsp;</span></p>
+<p id='t453' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; indent (default = 4) -- set indentation amount</span><span class='strut'>&nbsp;</span></p>
+<p id='t454' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; eol (default = &#39;\n&#39;) -- set end of line character(s)</span><span class='strut'>&nbsp;</span></p>
+<p id='t455' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; pretty (default = True) -- curtail long list output with a &#39;...&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t456' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; max_chars (default = 80) -- set max characters per line</span><span class='strut'>&nbsp;</span></p>
+<p id='t457' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t458' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t459' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t460' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t461' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='str'>&quot;{name}()&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t462' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>=</span> <span class='str'>&quot;{name}([{eol}{indent}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t463' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t464' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t465' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>level</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t466' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t467' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>entry</span><span class='op'>.</span><span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>=</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t468' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='nam'>indent</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t469' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t470' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>pretty</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t471' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>max_chars</span><span class='op'>=</span><span class='nam'>max_chars</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t472' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>index</span> <span class='op'>&lt;</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span> <span class='op'>-</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t473' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;,{eol}{indent}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t474' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t475' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>level</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t476' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;{eol}{indent}])&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='nam'>level</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t477' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>string</span><span class='strut'>&nbsp;</span></p>
 <p id='t478' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t479' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>force_clean</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t480' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Attempts to convert to graph_objs and calls force_clean() on entries.</span><span class='strut'>&nbsp;</span></p>
-<p id='t481' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t482' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Calling force_clean() on a PlotlyList will ensure that the object is</span><span class='strut'>&nbsp;</span></p>
-<p id='t483' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; valid and may be sent to plotly. This process will remove any entries</span><span class='strut'>&nbsp;</span></p>
-<p id='t484' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; that end up with a length == 0. It will also remove itself from</span><span class='strut'>&nbsp;</span></p>
-<p id='t485' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; enclosing trivial structures if it is enclosed by a collection with</span><span class='strut'>&nbsp;</span></p>
-<p id='t486' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; length 1, meaning the data is the ONLY object in the collection.</span><span class='strut'>&nbsp;</span></p>
-<p id='t487' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t488' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Careful! This will delete any invalid entries *silently*.</span><span class='strut'>&nbsp;</span></p>
-<p id='t489' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t490' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t491' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t492' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># TODO add error handling here!</span><span class='strut'>&nbsp;</span></p>
-<p id='t493' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t494' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>entry</span><span class='op'>.</span><span class='nam'>force_clean</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t495' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_indicies</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>index</span> <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>item</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t496' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>item</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t497' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_ct</span> <span class='op'>=</span> <span class='num'>0</span><span class='strut'>&nbsp;</span></p>
-<p id='t498' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span> <span class='key'>in</span> <span class='nam'>del_indicies</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t499' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span> <span class='op'>-</span> <span class='nam'>del_ct</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t500' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_ct</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
-<p id='t501' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t502' class='stm run hide_run'><span class='op'>@</span><span class='nam'>six</span><span class='op'>.</span><span class='nam'>add_metaclass</span><span class='op'>(</span><span class='nam'>DictMeta</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t503' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>PlotlyDict</span><span class='op'>(</span><span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t504' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A base dict class for all objects that style a figure in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t505' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t506' class='pln'><span class='str'>&nbsp; &nbsp; A PlotlyDict can be instantiated like any dict object. This class</span><span class='strut'>&nbsp;</span></p>
-<p id='t507' class='pln'><span class='str'>&nbsp; &nbsp; offers some useful recursive methods that can be used by higher-level</span><span class='strut'>&nbsp;</span></p>
-<p id='t508' class='pln'><span class='str'>&nbsp; &nbsp; subclasses and containers so long as all plot objects are instantiated</span><span class='strut'>&nbsp;</span></p>
-<p id='t509' class='pln'><span class='str'>&nbsp; &nbsp; as a subclass of PlotlyDict. Each PlotlyDict should be instantiated</span><span class='strut'>&nbsp;</span></p>
-<p id='t510' class='pln'><span class='str'>&nbsp; &nbsp; with a `kind` keyword argument. This defines the special _info</span><span class='strut'>&nbsp;</span></p>
-<p id='t511' class='pln'><span class='str'>&nbsp; &nbsp; dictionary for the object.</span><span class='strut'>&nbsp;</span></p>
-<p id='t512' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t513' class='pln'><span class='str'>&nbsp; &nbsp; Any available methods that hold for a dict hold for a PlotlyDict.</span><span class='strut'>&nbsp;</span></p>
-<p id='t514' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t515' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t479' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>get_ordered</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t480' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t481' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t482' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t483' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t484' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_note</span><span class='op'>(</span><span class='str'>&quot;Could not order list because it could not be &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t485' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;converted to a valid graph object.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t486' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t487' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
+<p id='t488' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_list</span> <span class='op'>=</span> <span class='op'>[</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t489' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t490' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_list</span> <span class='op'>+=</span> <span class='op'>[</span><span class='nam'>entry</span><span class='op'>.</span><span class='nam'>get_ordered</span><span class='op'>(</span><span class='op'>)</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t491' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>ordered_list</span><span class='strut'>&nbsp;</span></p>
+<p id='t492' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t493' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t494' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>force_clean</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t495' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Attempts to convert to graph_objs and calls force_clean() on entries.</span><span class='strut'>&nbsp;</span></p>
+<p id='t496' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t497' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Calling force_clean() on a PlotlyList will ensure that the object is</span><span class='strut'>&nbsp;</span></p>
+<p id='t498' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; valid and may be sent to plotly. This process will remove any entries</span><span class='strut'>&nbsp;</span></p>
+<p id='t499' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; that end up with a length == 0. It will also remove itself from</span><span class='strut'>&nbsp;</span></p>
+<p id='t500' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; enclosing trivial structures if it is enclosed by a collection with</span><span class='strut'>&nbsp;</span></p>
+<p id='t501' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; length 1, meaning the data is the ONLY object in the collection.</span><span class='strut'>&nbsp;</span></p>
+<p id='t502' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t503' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Careful! This will delete any invalid entries *silently*.</span><span class='strut'>&nbsp;</span></p>
+<p id='t504' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t505' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t506' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t507' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># TODO add error handling here!</span><span class='strut'>&nbsp;</span></p>
+<p id='t508' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t509' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>entry</span><span class='op'>.</span><span class='nam'>force_clean</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t510' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_indicies</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>index</span> <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>item</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t511' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>item</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t512' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_ct</span> <span class='op'>=</span> <span class='num'>0</span><span class='strut'>&nbsp;</span></p>
+<p id='t513' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span> <span class='key'>in</span> <span class='nam'>del_indicies</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t514' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span> <span class='op'>-</span> <span class='nam'>del_ct</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t515' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_ct</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
 <p id='t516' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t517' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t518' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>class_name</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='strut'>&nbsp;</span></p>
-<p id='t519' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__init__</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t520' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>issubclass</span><span class='op'>(</span><span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>class_name</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t521' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='nam'>class_name</span> <span class='op'>!=</span> <span class='str'>&#39;PlotlyTrace&#39;</span><span class='op'>)</span> <span class='key'>and</span> <span class='op'>(</span><span class='nam'>class_name</span> <span class='op'>!=</span> <span class='str'>&#39;Trace&#39;</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t522' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>class_name</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t523' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t524' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span> <span class='op'>==</span> <span class='str'>&#39;PlotlyDict&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t525' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;\nThe PlotlyDict class is a base class of &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t526' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;dictionary-like graph_objs.\nIt is not meant to be &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t527' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;a user interface.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t528' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t529' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>update</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>dict1</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>dict2</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t530' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Update current dict with dict1 and then dict2.</span><span class='strut'>&nbsp;</span></p>
+<p id='t517' class='stm run hide_run'><span class='op'>@</span><span class='nam'>six</span><span class='op'>.</span><span class='nam'>add_metaclass</span><span class='op'>(</span><span class='nam'>DictMeta</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t518' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>PlotlyDict</span><span class='op'>(</span><span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t519' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A base dict class for all objects that style a figure in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t520' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t521' class='pln'><span class='str'>&nbsp; &nbsp; A PlotlyDict can be instantiated like any dict object. This class</span><span class='strut'>&nbsp;</span></p>
+<p id='t522' class='pln'><span class='str'>&nbsp; &nbsp; offers some useful recursive methods that can be used by higher-level</span><span class='strut'>&nbsp;</span></p>
+<p id='t523' class='pln'><span class='str'>&nbsp; &nbsp; subclasses and containers so long as all plot objects are instantiated</span><span class='strut'>&nbsp;</span></p>
+<p id='t524' class='pln'><span class='str'>&nbsp; &nbsp; as a subclass of PlotlyDict. Each PlotlyDict should be instantiated</span><span class='strut'>&nbsp;</span></p>
+<p id='t525' class='pln'><span class='str'>&nbsp; &nbsp; with a `kind` keyword argument. This defines the special _info</span><span class='strut'>&nbsp;</span></p>
+<p id='t526' class='pln'><span class='str'>&nbsp; &nbsp; dictionary for the object.</span><span class='strut'>&nbsp;</span></p>
+<p id='t527' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t528' class='pln'><span class='str'>&nbsp; &nbsp; Any available methods that hold for a dict hold for a PlotlyDict.</span><span class='strut'>&nbsp;</span></p>
+<p id='t529' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t530' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
 <p id='t531' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t532' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This recursively updates the structure of the original dictionary-like</span><span class='strut'>&nbsp;</span></p>
-<p id='t533' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; object with the new entries in the second and third objects. This</span><span class='strut'>&nbsp;</span></p>
-<p id='t534' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; allows users to update with large, nested structures.</span><span class='strut'>&nbsp;</span></p>
-<p id='t535' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t536' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Note, because the dict2 packs up all the keyword arguments, you can</span><span class='strut'>&nbsp;</span></p>
-<p id='t537' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; specify the changes as a list of keyword agruments.</span><span class='strut'>&nbsp;</span></p>
-<p id='t538' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t539' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Examples:</span><span class='strut'>&nbsp;</span></p>
-<p id='t540' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; # update with dict</span><span class='strut'>&nbsp;</span></p>
-<p id='t541' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; obj = Layout(title=&#39;my title&#39;, xaxis=XAxis(range=[0,1], domain=[0,1]))</span><span class='strut'>&nbsp;</span></p>
-<p id='t542' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; update_dict = dict(title=&#39;new title&#39;, xaxis=dict(domain=[0,.8]))</span><span class='strut'>&nbsp;</span></p>
-<p id='t543' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; obj.update(update_dict)</span><span class='strut'>&nbsp;</span></p>
-<p id='t544' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; obj</span><span class='strut'>&nbsp;</span></p>
-<p id='t545' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; {&#39;title&#39;: &#39;new title&#39;, &#39;xaxis&#39;: {&#39;range&#39;: [0,1], &#39;domain&#39;: [0,.8]}}</span><span class='strut'>&nbsp;</span></p>
+<p id='t532' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t533' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>class_name</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='strut'>&nbsp;</span></p>
+<p id='t534' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__init__</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t535' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>issubclass</span><span class='op'>(</span><span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>class_name</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t536' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='nam'>class_name</span> <span class='op'>!=</span> <span class='str'>&#39;PlotlyTrace&#39;</span><span class='op'>)</span> <span class='key'>and</span> <span class='op'>(</span><span class='nam'>class_name</span> <span class='op'>!=</span> <span class='str'>&#39;Trace&#39;</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t537' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>class_name</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t538' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t539' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span> <span class='op'>==</span> <span class='str'>&#39;PlotlyDict&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t540' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;\nThe PlotlyDict class is a base class of &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t541' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;dictionary-like graph_objs.\nIt is not meant to be &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t542' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;a user interface.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t543' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t544' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>update</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>dict1</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>dict2</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t545' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Update current dict with dict1 and then dict2.</span><span class='strut'>&nbsp;</span></p>
 <p id='t546' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t547' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; # update with list of keyword arguments</span><span class='strut'>&nbsp;</span></p>
-<p id='t548' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; obj = Layout(title=&#39;my title&#39;, xaxis=XAxis(range=[0,1], domain=[0,1]))</span><span class='strut'>&nbsp;</span></p>
-<p id='t549' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; obj.update(title=&#39;new title&#39;, xaxis=dict(domain=[0,.8]))</span><span class='strut'>&nbsp;</span></p>
-<p id='t550' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; obj</span><span class='strut'>&nbsp;</span></p>
-<p id='t551' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; {&#39;title&#39;: &#39;new title&#39;, &#39;xaxis&#39;: {&#39;range&#39;: [0,1], &#39;domain&#39;: [0,.8]}}</span><span class='strut'>&nbsp;</span></p>
-<p id='t552' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t553' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This &#39;fully&#39; supports duck-typing in that the call signature is</span><span class='strut'>&nbsp;</span></p>
-<p id='t554' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; identical, however this differs slightly from the normal update</span><span class='strut'>&nbsp;</span></p>
-<p id='t555' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; method provided by Python&#39;s dictionaries.</span><span class='strut'>&nbsp;</span></p>
-<p id='t556' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t557' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t558' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t559' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t560' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>dict1</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t561' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>dict1</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t562' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t563' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t564' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t565' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t566' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
-<p id='t567' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t568' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
-<p id='t569' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t570' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>dict2</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t571' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>dict2</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t572' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t573' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t574' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t575' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t576' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
-<p id='t577' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t578' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
-<p id='t579' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t580' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t581' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>strip_style</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t582' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Strip style from the current representation.</span><span class='strut'>&nbsp;</span></p>
-<p id='t583' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t584' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; All PlotlyDicts and PlotlyLists are guaranteed to survive the</span><span class='strut'>&nbsp;</span></p>
-<p id='t585' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; stripping process, though they made be left empty. This is allowable.</span><span class='strut'>&nbsp;</span></p>
-<p id='t586' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t587' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Keys that will be stripped in this process are tagged with</span><span class='strut'>&nbsp;</span></p>
-<p id='t588' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; `&#39;type&#39;: &#39;style&#39;` in the INFO dictionary listed in graph_objs_meta.py.</span><span class='strut'>&nbsp;</span></p>
-<p id='t589' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t590' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This process first attempts to convert nested collections from dicts</span><span class='strut'>&nbsp;</span></p>
-<p id='t591' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; or lists to subclasses of PlotlyList/PlotlyDict. This process forces</span><span class='strut'>&nbsp;</span></p>
-<p id='t592' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; a validation, which may throw exceptions.</span><span class='strut'>&nbsp;</span></p>
-<p id='t593' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t594' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Then, each of these objects call `strip_style` on themselves and so</span><span class='strut'>&nbsp;</span></p>
-<p id='t595' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; on, recursively until the entire structure has been validated and</span><span class='strut'>&nbsp;</span></p>
-<p id='t596' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; stripped.</span><span class='strut'>&nbsp;</span></p>
-<p id='t597' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t598' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t599' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t600' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t601' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>keys</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t602' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t603' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t604' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>strip_style</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t605' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t606' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t607' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;style&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t608' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>hasattr</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='str'>&#39;__iter__&#39;</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t609' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t610' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: Update the JSON</span><span class='strut'>&nbsp;</span></p>
-<p id='t611' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># print &quot;&#39;type&#39; not in {0} for {1}&quot;.format(obj_key, key)</span><span class='strut'>&nbsp;</span></p>
-<p id='t612' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t613' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t614' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>get_data</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t615' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns the JSON for the plot with non-data elements stripped.&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t616' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t617' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>class_name</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='strut'>&nbsp;</span></p>
-<p id='t618' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>class_name</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t619' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t620' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t621' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t622' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='op'>.</span><span class='nam'>get_data</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t623' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t624' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t625' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;data&#39;</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: Update the JSON</span><span class='strut'>&nbsp;</span></p>
-<p id='t626' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
-<p id='t627' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t628' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t629' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>keys</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>d</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t630' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t631' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>d</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>dict</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t632' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>d</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t633' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>d</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t634' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>d</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t635' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>d</span><span class='op'>.</span><span class='nam'>values</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t636' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>d</span><span class='strut'>&nbsp;</span></p>
-<p id='t637' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t638' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t639' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Walk obj, convert dicts and lists to plotly graph objs.</span><span class='strut'>&nbsp;</span></p>
-<p id='t640' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t641' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; For each key in the object, if it corresponds to a special key that</span><span class='strut'>&nbsp;</span></p>
-<p id='t642' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; should be associated with a graph object, the ordinary dict or list</span><span class='strut'>&nbsp;</span></p>
-<p id='t643' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; will be reinitialized as a special PlotlyDict or PlotlyList of the</span><span class='strut'>&nbsp;</span></p>
-<p id='t644' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; appropriate `kind`.</span><span class='strut'>&nbsp;</span></p>
-<p id='t645' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t646' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t647' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>info_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t648' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>keys</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t649' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>updated_keys</span> <span class='op'>=</span> <span class='nam'>graph_objs_tools</span><span class='op'>.</span><span class='nam'>update_keys</span><span class='op'>(</span><span class='nam'>keys</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t650' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>k_old</span><span class='op'>,</span> <span class='nam'>k_new</span> <span class='key'>in</span> <span class='nam'>zip</span><span class='op'>(</span><span class='nam'>keys</span><span class='op'>,</span> <span class='nam'>updated_keys</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t651' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>k_old</span> <span class='op'>!=</span> <span class='nam'>k_new</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t652' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>k_new</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>pop</span><span class='op'>(</span><span class='nam'>k_old</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t653' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t654' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t655' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The key, &#39;{old}&#39;, has been depreciated, it&#39;s been &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t656' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;converted to &#39;{new}&#39;. You should change your code to use &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t657' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;{new}&#39; in the future.&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t658' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>old</span><span class='op'>=</span><span class='nam'>k_old</span><span class='op'>,</span> <span class='nam'>new</span><span class='op'>=</span><span class='nam'>k_new</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t659' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t660' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>updated_keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t661' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t662' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t663' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t664' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t665' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_to_error_path</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t666' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t667' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
-<p id='t668' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>info_key</span><span class='op'>]</span> <span class='key'>and</span> <span class='str'>&#39;type&#39;</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>info_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t669' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>info_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;object&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t670' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>class_name</span> <span class='op'>=</span> <span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t671' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span> <span class='op'>=</span> <span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>class_name</span><span class='op'>]</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># gets constructor</span><span class='strut'>&nbsp;</span></p>
-<p id='t672' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t673' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t674' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t675' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>info_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;val_types&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t676' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t677' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='str'>&#39;undocumented&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t678' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyDictValueError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t679' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t680' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t681' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>value</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t682' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span><span class='op'>=</span><span class='nam'>val_types</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t683' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='str'>&quot;value needs to be dictionary-like&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t684' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t685' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>k</span><span class='op'>,</span> <span class='nam'>v</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>pop</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t686' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>[</span><span class='nam'>k</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>v</span>&nbsp; <span class='com'># finish up momentarily...</span><span class='strut'>&nbsp;</span></p>
-<p id='t687' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span>&nbsp; <span class='com'># if not PlotlyDict, it MUST be a PlotlyList</span><span class='strut'>&nbsp;</span></p>
-<p id='t688' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t689' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t690' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>info_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;val_types&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t691' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t692' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='str'>&#39;undocumented&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t693' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyDictValueError</span><span class='op'>(</span>&nbsp; <span class='com'># TODO!!!</span><span class='strut'>&nbsp;</span></p>
-<p id='t694' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t695' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t696' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>value</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t697' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span><span class='op'>=</span><span class='nam'>val_types</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t698' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='str'>&quot;value needs to be list-like&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t699' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t700' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span> <span class='op'>+=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>pop</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t701' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t702' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t703' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t704' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_to_error_path</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t705' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t706' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
-<p id='t707' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>obj</span>&nbsp; <span class='com'># whew! made it!</span><span class='strut'>&nbsp;</span></p>
-<p id='t708' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t709' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>validate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: validate values too?</span><span class='strut'>&nbsp;</span></p>
-<p id='t710' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Recursively check the validity of the keys in a PlotlyDict.</span><span class='strut'>&nbsp;</span></p>
-<p id='t711' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t712' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The valid keys constitute the entries in each object</span><span class='strut'>&nbsp;</span></p>
-<p id='t713' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; dictionary in INFO stored in graph_objs_meta.py.</span><span class='strut'>&nbsp;</span></p>
-<p id='t714' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t715' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The validation process first requires that all nested collections be</span><span class='strut'>&nbsp;</span></p>
-<p id='t716' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; converted to the appropriate subclass of PlotlyDict/PlotlyList. Then,</span><span class='strut'>&nbsp;</span></p>
-<p id='t717' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; each of these objects call `validate` and so on, recursively,</span><span class='strut'>&nbsp;</span></p>
-<p id='t718' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; until the entire object has been validated.</span><span class='strut'>&nbsp;</span></p>
-<p id='t719' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t720' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t721' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span>&nbsp; <span class='com'># change everything to &#39;checkable&#39; objs</span><span class='strut'>&nbsp;</span></p>
-<p id='t722' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t723' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t724' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t725' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t726' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
-<p id='t727' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t728' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t729' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t730' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t731' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t732' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t733' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_to_error_path</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t734' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t735' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
-<p id='t736' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t737' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t738' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;type&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t739' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>continue</span>&nbsp; <span class='com'># TODO: &#39;type&#39; may not be documented yet!</span><span class='strut'>&nbsp;</span></p>
-<p id='t740' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;object&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t741' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t742' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;val_types&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t743' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t744' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='str'>&#39;undocumented&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t745' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyDictValueError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t746' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t747' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t748' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>value</span><span class='op'>=</span><span class='nam'>val</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t749' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span><span class='op'>=</span><span class='nam'>val_types</span><span class='strut'>&nbsp;</span></p>
-<p id='t750' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t751' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t752' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>matching_objects</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>obj</span> <span class='key'>for</span> <span class='nam'>obj</span> <span class='key'>in</span> <span class='nam'>INFO</span> <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t753' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span> <span class='op'>=</span> <span class='str'>&#39;&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t754' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>matching_objects</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t755' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span> <span class='op'>+=</span> <span class='str'>&quot;That key is valid only in these objects:\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t756' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>obj</span> <span class='key'>in</span> <span class='nam'>matching_objects</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t757' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span> <span class='op'>+=</span> <span class='str'>&quot;\t{0}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>obj</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t758' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t759' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span> <span class='op'>+=</span> <span class='str'>&#39;({0}=&quot;{1}&quot;)\n&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t760' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>repr</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>,</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;val_types&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t761' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t762' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span> <span class='op'>+=</span> <span class='str'>&#39;({0}=&quot;..&quot;)\n&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>repr</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t763' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>.</span><span class='nam'>expandtabs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t764' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t765' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span> <span class='op'>+=</span> <span class='op'>(</span><span class='str'>&quot;Couldn&#39;t find uses for key: {0}\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t766' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>repr</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t767' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyDictKeyError</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t768' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t769' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='nam'>notes</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t770' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t771' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>level</span><span class='op'>=</span><span class='num'>0</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='num'>4</span><span class='op'>,</span> <span class='nam'>eol</span><span class='op'>=</span><span class='str'>&#39;\n&#39;</span><span class='op'>,</span> <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='nam'>max_chars</span><span class='op'>=</span><span class='num'>80</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t772' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns a formatted string showing graph_obj constructors.</span><span class='strut'>&nbsp;</span></p>
-<p id='t773' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t774' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t775' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t776' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; print obj.to_string()</span><span class='strut'>&nbsp;</span></p>
-<p id='t777' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t778' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t779' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; level (default = 0) -- set number of indentations to start with</span><span class='strut'>&nbsp;</span></p>
-<p id='t780' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; indent (default = 4) -- set indentation amount</span><span class='strut'>&nbsp;</span></p>
-<p id='t781' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; eol (default = &#39;\n&#39;) -- set end of line character(s)</span><span class='strut'>&nbsp;</span></p>
-<p id='t782' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; pretty (default = True) -- curtail long list output with a &#39;...&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t783' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; max_chars (default = 80) -- set max characters per line</span><span class='strut'>&nbsp;</span></p>
-<p id='t784' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t785' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t786' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># todo, consider catching and re-raising?</span><span class='strut'>&nbsp;</span></p>
-<p id='t787' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t788' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='str'>&quot;{name}()&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t789' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>=</span> <span class='str'>&quot;{name}(&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t790' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span> <span class='op'>=</span> <span class='num'>0</span><span class='strut'>&nbsp;</span></p>
-<p id='t791' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t792' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>:</span>&nbsp; <span class='com'># this sets the order of the keys! nice.</span><span class='strut'>&nbsp;</span></p>
-<p id='t793' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t794' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;{eol}{indent}{key}=&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t795' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t796' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t797' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t798' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t799' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>=</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t800' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='nam'>indent</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t801' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t802' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>pretty</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t803' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>max_chars</span><span class='op'>=</span><span class='nam'>max_chars</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t804' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t805' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val</span> <span class='op'>=</span> <span class='nam'>repr</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t806' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_chars</span> <span class='op'>=</span> <span class='nam'>max_chars</span> <span class='op'>-</span> <span class='op'>(</span><span class='nam'>indent</span><span class='op'>*</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>-</span> <span class='op'>(</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t807' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>pretty</span> <span class='key'>and</span> <span class='op'>(</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>)</span> <span class='op'>&gt;</span> <span class='nam'>val_chars</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t808' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>val</span><span class='op'>[</span><span class='op'>:</span><span class='nam'>val_chars</span> <span class='op'>-</span> <span class='num'>5</span><span class='op'>]</span> <span class='op'>+</span> <span class='str'>&#39;...&#39;</span> <span class='op'>+</span> <span class='nam'>val</span><span class='op'>[</span><span class='op'>-</span><span class='num'>1</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t809' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t810' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
-<p id='t811' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>index</span> <span class='op'>&lt;</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span> <span class='op'>-</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t812' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;,&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t813' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
-<p id='t814' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>index</span> <span class='op'>==</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t815' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>break</span><span class='strut'>&nbsp;</span></p>
-<p id='t816' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;{eol}{indent})&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='nam'>level</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t817' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>string</span><span class='strut'>&nbsp;</span></p>
-<p id='t818' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t819' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>get_ordered</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t820' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span>&nbsp; <span class='com'># change everything to &#39;order-able&#39; objs</span><span class='strut'>&nbsp;</span></p>
-<p id='t821' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t822' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t823' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t824' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_note</span><span class='op'>(</span><span class='str'>&quot;dictionary could not be ordered because it &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t825' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;could not be converted to a valid plotly graph &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t826' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;object.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t827' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t828' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
-<p id='t829' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_type</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t830' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_dict</span> <span class='op'>=</span> <span class='nam'>OrderedDict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t831' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># grab keys like xaxis1, xaxis2, etc...</span><span class='strut'>&nbsp;</span></p>
-<p id='t832' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>unordered_keys</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>key</span> <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span> <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t833' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t834' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t835' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t836' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_dict</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>get_ordered</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t837' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t838' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_dict</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t839' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>unordered_keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t840' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t841' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_dict</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>get_ordered</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t842' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t843' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_dict</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t844' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>ordered_dict</span><span class='strut'>&nbsp;</span></p>
-<p id='t845' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t846' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t847' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>force_clean</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t848' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Attempts to convert to graph_objs and call force_clean() on values.</span><span class='strut'>&nbsp;</span></p>
-<p id='t849' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t850' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Calling force_clean() on a PlotlyDict will ensure that the object is</span><span class='strut'>&nbsp;</span></p>
-<p id='t851' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; valid and may be sent to plotly. This process will also remove any</span><span class='strut'>&nbsp;</span></p>
-<p id='t852' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; entries that end up with a length == 0.</span><span class='strut'>&nbsp;</span></p>
-<p id='t853' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t854' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Careful! This will delete any invalid entries *silently*.</span><span class='strut'>&nbsp;</span></p>
-<p id='t855' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t856' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t857' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t858' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t859' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t860' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_keys</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>key</span> <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span> <span class='key'>if</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t861' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>del_keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t862' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t863' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>keys</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t864' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t865' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t866' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>force_clean</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span>&nbsp; <span class='com'># TODO: add error handling</span><span class='strut'>&nbsp;</span></p>
-<p id='t867' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t868' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t869' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>dict</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t870' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t871' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span>&nbsp; <span class='com'># clears empty collections!</span><span class='strut'>&nbsp;</span></p>
-<p id='t872' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='key'>is</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t873' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t874' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t875' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t876' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Data</span><span class='op'>(</span><span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t877' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A list of traces to be shown on a plot/graph.</span><span class='strut'>&nbsp;</span></p>
-<p id='t878' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t879' class='pln'><span class='str'>&nbsp; &nbsp; Any operation that can be done with a standard list may be used with Data.</span><span class='strut'>&nbsp;</span></p>
-<p id='t880' class='pln'><span class='str'>&nbsp; &nbsp; Instantiation requires an iterable (just like list does), for example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t881' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t882' class='pln'><span class='str'>&nbsp; &nbsp; Data([Scatter(), Heatmap(), Box()])</span><span class='strut'>&nbsp;</span></p>
-<p id='t883' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t884' class='pln'><span class='str'>&nbsp; &nbsp; Valid entry types: (dict or any subclass of Trace, i.e., Scatter, Box, etc.)</span><span class='strut'>&nbsp;</span></p>
-<p id='t885' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t886' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t887' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span>&nbsp; <span class='com'># TODO TODO TODO! check logic!</span><span class='strut'>&nbsp;</span></p>
-<p id='t888' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Change any nested collections to subclasses of PlotlyDict/List.</span><span class='strut'>&nbsp;</span></p>
-<p id='t889' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t890' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Procedure:</span><span class='strut'>&nbsp;</span></p>
-<p id='t891' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 1. Attempt to convert all entries to a subclass of PlotlyTrace.</span><span class='strut'>&nbsp;</span></p>
-<p id='t892' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2. Call `to_graph_objects` on each of these entries.</span><span class='strut'>&nbsp;</span></p>
-<p id='t893' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t894' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t895' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t896' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t897' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>entry</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t898' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t899' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;type&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>entry</span><span class='op'>:</span>&nbsp; <span class='com'># assume &#39;scatter&#39; if not given</span><span class='strut'>&nbsp;</span></p>
-<p id='t900' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>entry</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='str'>&#39;scatter&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t901' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t902' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_name</span> <span class='op'>=</span> <span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>entry</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t903' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t904' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyDataTypeError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t905' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t906' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span><span class='op'>=</span><span class='nam'>index</span><span class='strut'>&nbsp;</span></p>
-<p id='t907' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t908' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span> <span class='op'>=</span> <span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>obj_name</span><span class='op'>]</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># don&#39;t hide if KeyError!</span><span class='strut'>&nbsp;</span></p>
-<p id='t909' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>k</span><span class='op'>,</span> <span class='nam'>v</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t910' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>[</span><span class='nam'>k</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>v</span><span class='strut'>&nbsp;</span></p>
-<p id='t911' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>obj</span><span class='strut'>&nbsp;</span></p>
-<p id='t912' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span>&nbsp; <span class='com'># Trace ONLY!!!</span><span class='strut'>&nbsp;</span></p>
-<p id='t913' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyListEntryError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t914' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t915' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span><span class='op'>=</span><span class='nam'>index</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t916' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='str'>&quot;The entry could not be converted into a PlotlyTrace &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t917' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;object (e.g., Scatter, Heatmap, Bar, etc).&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t918' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t919' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>Data</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>caller</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t920' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t921' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t922' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Annotations</span><span class='op'>(</span><span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t923' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A list-like object to contain all figure notes.</span><span class='strut'>&nbsp;</span></p>
-<p id='t924' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t925' class='pln'><span class='str'>&nbsp; &nbsp; Any operation that can be done with a standard list may be used with</span><span class='strut'>&nbsp;</span></p>
-<p id='t926' class='pln'><span class='str'>&nbsp; &nbsp; Annotations. Instantiation requires an iterable (just like list does),</span><span class='strut'>&nbsp;</span></p>
-<p id='t927' class='pln'><span class='str'>&nbsp; &nbsp; for example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t928' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t929' class='pln'><span class='str'>&nbsp; &nbsp; Annotations([Annotation(), Annotation(), Annotation()])</span><span class='strut'>&nbsp;</span></p>
-<p id='t930' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t931' class='pln'><span class='str'>&nbsp; &nbsp; This Annotations list is validated upon instantiation, meaning exceptions</span><span class='strut'>&nbsp;</span></p>
-<p id='t932' class='pln'><span class='str'>&nbsp; &nbsp; will be thrown if any invalid entries are found.</span><span class='strut'>&nbsp;</span></p>
-<p id='t933' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t934' class='pln'><span class='str'>&nbsp; &nbsp; Valid entry types: (dict or Annotation)</span><span class='strut'>&nbsp;</span></p>
-<p id='t935' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t936' class='pln'><span class='str'>&nbsp; &nbsp; For help on Annotation, run `help(plotly.graph_objs.Annotation)`</span><span class='strut'>&nbsp;</span></p>
+<p id='t547' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This recursively updates the structure of the original dictionary-like</span><span class='strut'>&nbsp;</span></p>
+<p id='t548' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; object with the new entries in the second and third objects. This</span><span class='strut'>&nbsp;</span></p>
+<p id='t549' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; allows users to update with large, nested structures.</span><span class='strut'>&nbsp;</span></p>
+<p id='t550' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t551' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Note, because the dict2 packs up all the keyword arguments, you can</span><span class='strut'>&nbsp;</span></p>
+<p id='t552' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; specify the changes as a list of keyword agruments.</span><span class='strut'>&nbsp;</span></p>
+<p id='t553' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t554' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Examples:</span><span class='strut'>&nbsp;</span></p>
+<p id='t555' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; # update with dict</span><span class='strut'>&nbsp;</span></p>
+<p id='t556' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; obj = Layout(title=&#39;my title&#39;, xaxis=XAxis(range=[0,1], domain=[0,1]))</span><span class='strut'>&nbsp;</span></p>
+<p id='t557' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; update_dict = dict(title=&#39;new title&#39;, xaxis=dict(domain=[0,.8]))</span><span class='strut'>&nbsp;</span></p>
+<p id='t558' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; obj.update(update_dict)</span><span class='strut'>&nbsp;</span></p>
+<p id='t559' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; obj</span><span class='strut'>&nbsp;</span></p>
+<p id='t560' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; {&#39;title&#39;: &#39;new title&#39;, &#39;xaxis&#39;: {&#39;range&#39;: [0,1], &#39;domain&#39;: [0,.8]}}</span><span class='strut'>&nbsp;</span></p>
+<p id='t561' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t562' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; # update with list of keyword arguments</span><span class='strut'>&nbsp;</span></p>
+<p id='t563' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; obj = Layout(title=&#39;my title&#39;, xaxis=XAxis(range=[0,1], domain=[0,1]))</span><span class='strut'>&nbsp;</span></p>
+<p id='t564' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; obj.update(title=&#39;new title&#39;, xaxis=dict(domain=[0,.8]))</span><span class='strut'>&nbsp;</span></p>
+<p id='t565' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; obj</span><span class='strut'>&nbsp;</span></p>
+<p id='t566' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; {&#39;title&#39;: &#39;new title&#39;, &#39;xaxis&#39;: {&#39;range&#39;: [0,1], &#39;domain&#39;: [0,.8]}}</span><span class='strut'>&nbsp;</span></p>
+<p id='t567' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t568' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This &#39;fully&#39; supports duck-typing in that the call signature is</span><span class='strut'>&nbsp;</span></p>
+<p id='t569' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; identical, however this differs slightly from the normal update</span><span class='strut'>&nbsp;</span></p>
+<p id='t570' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; method provided by Python&#39;s dictionaries.</span><span class='strut'>&nbsp;</span></p>
+<p id='t571' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t572' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t573' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t574' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t575' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>dict1</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t576' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>dict1</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t577' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t578' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t579' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t580' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t581' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
+<p id='t582' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t583' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
+<p id='t584' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t585' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>dict2</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t586' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>dict2</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t587' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t588' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t589' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t590' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t591' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
+<p id='t592' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t593' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
+<p id='t594' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t595' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t596' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>strip_style</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t597' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Strip style from the current representation.</span><span class='strut'>&nbsp;</span></p>
+<p id='t598' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t599' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; All PlotlyDicts and PlotlyLists are guaranteed to survive the</span><span class='strut'>&nbsp;</span></p>
+<p id='t600' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; stripping process, though they made be left empty. This is allowable.</span><span class='strut'>&nbsp;</span></p>
+<p id='t601' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t602' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Keys that will be stripped in this process are tagged with</span><span class='strut'>&nbsp;</span></p>
+<p id='t603' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; `&#39;type&#39;: &#39;style&#39;` in the INFO dictionary listed in graph_objs_meta.py.</span><span class='strut'>&nbsp;</span></p>
+<p id='t604' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t605' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This process first attempts to convert nested collections from dicts</span><span class='strut'>&nbsp;</span></p>
+<p id='t606' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; or lists to subclasses of PlotlyList/PlotlyDict. This process forces</span><span class='strut'>&nbsp;</span></p>
+<p id='t607' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; a validation, which may throw exceptions.</span><span class='strut'>&nbsp;</span></p>
+<p id='t608' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t609' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Then, each of these objects call `strip_style` on themselves and so</span><span class='strut'>&nbsp;</span></p>
+<p id='t610' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; on, recursively until the entire structure has been validated and</span><span class='strut'>&nbsp;</span></p>
+<p id='t611' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; stripped.</span><span class='strut'>&nbsp;</span></p>
+<p id='t612' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t613' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t614' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t615' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t616' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>keys</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t617' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t618' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t619' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>strip_style</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t620' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t621' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t622' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;style&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t623' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>six</span><span class='op'>.</span><span class='nam'>string_types</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t624' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t625' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='key'>not</span> <span class='nam'>hasattr</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='str'>&#39;__iter__&#39;</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t626' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t627' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: Update the JSON</span><span class='strut'>&nbsp;</span></p>
+<p id='t628' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># print &quot;&#39;type&#39; not in {0} for {1}&quot;.format(obj_key, key)</span><span class='strut'>&nbsp;</span></p>
+<p id='t629' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t630' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t631' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>get_data</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t632' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns the JSON for the plot with non-data elements stripped.&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t633' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t634' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>class_name</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='strut'>&nbsp;</span></p>
+<p id='t635' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>class_name</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t636' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t637' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t638' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t639' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='op'>.</span><span class='nam'>get_data</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t640' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t641' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t642' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;data&#39;</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: Update the JSON</span><span class='strut'>&nbsp;</span></p>
+<p id='t643' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
+<p id='t644' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t645' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t646' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>keys</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>d</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t647' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t648' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>d</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>dict</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t649' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>d</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t650' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>d</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t651' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>d</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t652' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>d</span><span class='op'>.</span><span class='nam'>values</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t653' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>d</span><span class='strut'>&nbsp;</span></p>
+<p id='t654' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t655' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t656' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Walk obj, convert dicts and lists to plotly graph objs.</span><span class='strut'>&nbsp;</span></p>
+<p id='t657' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t658' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; For each key in the object, if it corresponds to a special key that</span><span class='strut'>&nbsp;</span></p>
+<p id='t659' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; should be associated with a graph object, the ordinary dict or list</span><span class='strut'>&nbsp;</span></p>
+<p id='t660' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; will be reinitialized as a special PlotlyDict or PlotlyList of the</span><span class='strut'>&nbsp;</span></p>
+<p id='t661' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; appropriate `kind`.</span><span class='strut'>&nbsp;</span></p>
+<p id='t662' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t663' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t664' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>info_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t665' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>keys</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t666' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>updated_keys</span> <span class='op'>=</span> <span class='nam'>graph_objs_tools</span><span class='op'>.</span><span class='nam'>update_keys</span><span class='op'>(</span><span class='nam'>keys</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t667' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>k_old</span><span class='op'>,</span> <span class='nam'>k_new</span> <span class='key'>in</span> <span class='nam'>zip</span><span class='op'>(</span><span class='nam'>keys</span><span class='op'>,</span> <span class='nam'>updated_keys</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t668' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>k_old</span> <span class='op'>!=</span> <span class='nam'>k_new</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t669' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>k_new</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>pop</span><span class='op'>(</span><span class='nam'>k_old</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t670' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t671' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t672' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The key, &#39;{old}&#39;, has been depreciated, it&#39;s been &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t673' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;converted to &#39;{new}&#39;. You should change your code to use &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t674' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;{new}&#39; in the future.&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t675' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>old</span><span class='op'>=</span><span class='nam'>k_old</span><span class='op'>,</span> <span class='nam'>new</span><span class='op'>=</span><span class='nam'>k_new</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t676' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t677' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>updated_keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t678' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t679' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t680' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t681' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t682' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_to_error_path</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t683' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t684' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
+<p id='t685' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>info_key</span><span class='op'>]</span> <span class='key'>and</span> <span class='str'>&#39;type&#39;</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>info_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t686' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>info_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;object&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t687' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>class_name</span> <span class='op'>=</span> <span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t688' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span> <span class='op'>=</span> <span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>class_name</span><span class='op'>]</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># gets constructor</span><span class='strut'>&nbsp;</span></p>
+<p id='t689' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t690' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t691' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t692' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>info_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;val_types&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t693' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t694' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='str'>&#39;undocumented&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t695' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyDictValueError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t696' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t697' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t698' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>value</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t699' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span><span class='op'>=</span><span class='nam'>val_types</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t700' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='str'>&quot;value needs to be dictionary-like&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t701' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t702' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>k</span><span class='op'>,</span> <span class='nam'>v</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>pop</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t703' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>[</span><span class='nam'>k</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>v</span>&nbsp; <span class='com'># finish up momentarily...</span><span class='strut'>&nbsp;</span></p>
+<p id='t704' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span>&nbsp; <span class='com'># if not PlotlyDict, it MUST be a PlotlyList</span><span class='strut'>&nbsp;</span></p>
+<p id='t705' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t706' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t707' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>info_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;val_types&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t708' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t709' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='str'>&#39;undocumented&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t710' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyDictValueError</span><span class='op'>(</span>&nbsp; <span class='com'># TODO!!!</span><span class='strut'>&nbsp;</span></p>
+<p id='t711' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t712' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t713' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>value</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t714' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span><span class='op'>=</span><span class='nam'>val_types</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t715' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='str'>&quot;value needs to be list-like&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t716' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t717' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span> <span class='op'>+=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>pop</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t718' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t719' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t720' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t721' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_to_error_path</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t722' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t723' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
+<p id='t724' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>obj</span>&nbsp; <span class='com'># whew! made it!</span><span class='strut'>&nbsp;</span></p>
+<p id='t725' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t726' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>validate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: validate values too?</span><span class='strut'>&nbsp;</span></p>
+<p id='t727' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Recursively check the validity of the keys in a PlotlyDict.</span><span class='strut'>&nbsp;</span></p>
+<p id='t728' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t729' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The valid keys constitute the entries in each object</span><span class='strut'>&nbsp;</span></p>
+<p id='t730' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; dictionary in INFO stored in graph_objs_meta.py.</span><span class='strut'>&nbsp;</span></p>
+<p id='t731' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t732' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The validation process first requires that all nested collections be</span><span class='strut'>&nbsp;</span></p>
+<p id='t733' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; converted to the appropriate subclass of PlotlyDict/PlotlyList. Then,</span><span class='strut'>&nbsp;</span></p>
+<p id='t734' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; each of these objects call `validate` and so on, recursively,</span><span class='strut'>&nbsp;</span></p>
+<p id='t735' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; until the entire object has been validated.</span><span class='strut'>&nbsp;</span></p>
+<p id='t736' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t737' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t738' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span>&nbsp; <span class='com'># change everything to &#39;checkable&#39; objs</span><span class='strut'>&nbsp;</span></p>
+<p id='t739' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t740' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t741' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t742' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t743' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
+<p id='t744' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t745' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t746' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t747' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t748' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t749' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t750' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_to_error_path</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t751' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t752' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
+<p id='t753' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t754' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t755' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;type&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t756' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>continue</span>&nbsp; <span class='com'># TODO: &#39;type&#39; may not be documented yet!</span><span class='strut'>&nbsp;</span></p>
+<p id='t757' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;object&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t758' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t759' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;val_types&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t760' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t761' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span> <span class='op'>=</span> <span class='str'>&#39;undocumented&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t762' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyDictValueError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t763' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t764' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t765' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>value</span><span class='op'>=</span><span class='nam'>val</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t766' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_types</span><span class='op'>=</span><span class='nam'>val_types</span><span class='strut'>&nbsp;</span></p>
+<p id='t767' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t768' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t769' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>matching_objects</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>obj</span> <span class='key'>for</span> <span class='nam'>obj</span> <span class='key'>in</span> <span class='nam'>INFO</span> <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t770' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span> <span class='op'>=</span> <span class='str'>&#39;&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t771' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>matching_objects</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t772' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span> <span class='op'>+=</span> <span class='str'>&quot;That key is valid only in these objects:\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t773' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>obj</span> <span class='key'>in</span> <span class='nam'>matching_objects</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t774' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span> <span class='op'>+=</span> <span class='str'>&quot;\t{0}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>obj</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t775' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t776' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span> <span class='op'>+=</span> <span class='str'>&#39;({0}=&quot;{1}&quot;)\n&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t777' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>repr</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>,</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;val_types&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t778' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t779' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span> <span class='op'>+=</span> <span class='str'>&#39;({0}=&quot;..&quot;)\n&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>repr</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t780' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>.</span><span class='nam'>expandtabs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t781' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t782' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span> <span class='op'>+=</span> <span class='op'>(</span><span class='str'>&quot;Couldn&#39;t find uses for key: {0}\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t783' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>repr</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t784' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyDictKeyError</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t785' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t786' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='nam'>notes</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t787' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t788' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>level</span><span class='op'>=</span><span class='num'>0</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='num'>4</span><span class='op'>,</span> <span class='nam'>eol</span><span class='op'>=</span><span class='str'>&#39;\n&#39;</span><span class='op'>,</span> <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='nam'>max_chars</span><span class='op'>=</span><span class='num'>80</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t789' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns a formatted string showing graph_obj constructors.</span><span class='strut'>&nbsp;</span></p>
+<p id='t790' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t791' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t792' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t793' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; print obj.to_string()</span><span class='strut'>&nbsp;</span></p>
+<p id='t794' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t795' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t796' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; level (default = 0) -- set number of indentations to start with</span><span class='strut'>&nbsp;</span></p>
+<p id='t797' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; indent (default = 4) -- set indentation amount</span><span class='strut'>&nbsp;</span></p>
+<p id='t798' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; eol (default = &#39;\n&#39;) -- set end of line character(s)</span><span class='strut'>&nbsp;</span></p>
+<p id='t799' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; pretty (default = True) -- curtail long list output with a &#39;...&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t800' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; max_chars (default = 80) -- set max characters per line</span><span class='strut'>&nbsp;</span></p>
+<p id='t801' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t802' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t803' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># todo, consider catching and re-raising?</span><span class='strut'>&nbsp;</span></p>
+<p id='t804' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t805' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='str'>&quot;{name}()&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t806' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>=</span> <span class='str'>&quot;{name}(&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t807' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span> <span class='op'>=</span> <span class='num'>0</span><span class='strut'>&nbsp;</span></p>
+<p id='t808' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t809' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>:</span>&nbsp; <span class='com'># this sets the order of the keys! nice.</span><span class='strut'>&nbsp;</span></p>
+<p id='t810' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t811' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;{eol}{indent}{key}=&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t812' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t813' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t814' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t815' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t816' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>=</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t817' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='nam'>indent</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t818' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t819' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>pretty</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t820' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>max_chars</span><span class='op'>=</span><span class='nam'>max_chars</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t821' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t822' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val</span> <span class='op'>=</span> <span class='nam'>repr</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t823' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_chars</span> <span class='op'>=</span> <span class='nam'>max_chars</span> <span class='op'>-</span> <span class='op'>(</span><span class='nam'>indent</span><span class='op'>*</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>-</span> <span class='op'>(</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t824' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>pretty</span> <span class='key'>and</span> <span class='op'>(</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>)</span> <span class='op'>&gt;</span> <span class='nam'>val_chars</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t825' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>val</span><span class='op'>[</span><span class='op'>:</span><span class='nam'>val_chars</span> <span class='op'>-</span> <span class='num'>5</span><span class='op'>]</span> <span class='op'>+</span> <span class='str'>&#39;...&#39;</span> <span class='op'>+</span> <span class='nam'>val</span><span class='op'>[</span><span class='op'>-</span><span class='num'>1</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t826' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t827' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
+<p id='t828' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>index</span> <span class='op'>&lt;</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span> <span class='op'>-</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t829' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;,&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t830' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
+<p id='t831' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>index</span> <span class='op'>==</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t832' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>break</span><span class='strut'>&nbsp;</span></p>
+<p id='t833' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;{eol}{indent})&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='nam'>level</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t834' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>string</span><span class='strut'>&nbsp;</span></p>
+<p id='t835' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t836' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>get_ordered</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t837' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span>&nbsp; <span class='com'># change everything to &#39;order-able&#39; objs</span><span class='strut'>&nbsp;</span></p>
+<p id='t838' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t839' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t840' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t841' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_note</span><span class='op'>(</span><span class='str'>&quot;dictionary could not be ordered because it &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t842' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;could not be converted to a valid plotly graph &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t843' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;object.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t844' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t845' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
+<p id='t846' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_type</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t847' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_dict</span> <span class='op'>=</span> <span class='nam'>OrderedDict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t848' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># grab keys like xaxis1, xaxis2, etc...</span><span class='strut'>&nbsp;</span></p>
+<p id='t849' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>unordered_keys</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>key</span> <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span> <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t850' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t851' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t852' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t853' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_dict</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>get_ordered</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t854' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t855' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_dict</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t856' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>unordered_keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t857' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t858' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_dict</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>get_ordered</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t859' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t860' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ordered_dict</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t861' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>ordered_dict</span><span class='strut'>&nbsp;</span></p>
+<p id='t862' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t863' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t864' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>force_clean</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t865' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Attempts to convert to graph_objs and call force_clean() on values.</span><span class='strut'>&nbsp;</span></p>
+<p id='t866' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t867' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Calling force_clean() on a PlotlyDict will ensure that the object is</span><span class='strut'>&nbsp;</span></p>
+<p id='t868' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; valid and may be sent to plotly. This process will also remove any</span><span class='strut'>&nbsp;</span></p>
+<p id='t869' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; entries that end up with a length == 0.</span><span class='strut'>&nbsp;</span></p>
+<p id='t870' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t871' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Careful! This will delete any invalid entries *silently*.</span><span class='strut'>&nbsp;</span></p>
+<p id='t872' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t873' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t874' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t875' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t876' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t877' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_keys</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>key</span> <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span> <span class='key'>if</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t878' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>del_keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t879' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t880' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>keys</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t881' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t882' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t883' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>force_clean</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span>&nbsp; <span class='com'># TODO: add error handling</span><span class='strut'>&nbsp;</span></p>
+<p id='t884' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t885' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t886' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>dict</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t887' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t888' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span>&nbsp; <span class='com'># clears empty collections!</span><span class='strut'>&nbsp;</span></p>
+<p id='t889' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='key'>is</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t890' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t891' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t892' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t893' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Data</span><span class='op'>(</span><span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t894' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A list of traces to be shown on a plot/graph.</span><span class='strut'>&nbsp;</span></p>
+<p id='t895' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t896' class='pln'><span class='str'>&nbsp; &nbsp; Any operation that can be done with a standard list may be used with Data.</span><span class='strut'>&nbsp;</span></p>
+<p id='t897' class='pln'><span class='str'>&nbsp; &nbsp; Instantiation requires an iterable (just like list does), for example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t898' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t899' class='pln'><span class='str'>&nbsp; &nbsp; Data([Scatter(), Heatmap(), Box()])</span><span class='strut'>&nbsp;</span></p>
+<p id='t900' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t901' class='pln'><span class='str'>&nbsp; &nbsp; Valid entry types: (dict or any subclass of Trace, i.e., Scatter, Box, etc.)</span><span class='strut'>&nbsp;</span></p>
+<p id='t902' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t903' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t904' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span>&nbsp; <span class='com'># TODO TODO TODO! check logic!</span><span class='strut'>&nbsp;</span></p>
+<p id='t905' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Change any nested collections to subclasses of PlotlyDict/List.</span><span class='strut'>&nbsp;</span></p>
+<p id='t906' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t907' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Procedure:</span><span class='strut'>&nbsp;</span></p>
+<p id='t908' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 1. Attempt to convert all entries to a subclass of PlotlyTrace.</span><span class='strut'>&nbsp;</span></p>
+<p id='t909' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2. Call `to_graph_objects` on each of these entries.</span><span class='strut'>&nbsp;</span></p>
+<p id='t910' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t911' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t912' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t913' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t914' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>entry</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t915' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t916' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;type&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>entry</span><span class='op'>:</span>&nbsp; <span class='com'># assume &#39;scatter&#39; if not given</span><span class='strut'>&nbsp;</span></p>
+<p id='t917' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>entry</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='str'>&#39;scatter&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t918' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t919' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_name</span> <span class='op'>=</span> <span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>entry</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t920' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t921' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyDataTypeError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t922' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t923' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span><span class='op'>=</span><span class='nam'>index</span><span class='strut'>&nbsp;</span></p>
+<p id='t924' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t925' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span> <span class='op'>=</span> <span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>obj_name</span><span class='op'>]</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># don&#39;t hide if KeyError!</span><span class='strut'>&nbsp;</span></p>
+<p id='t926' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>k</span><span class='op'>,</span> <span class='nam'>v</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t927' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>[</span><span class='nam'>k</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>v</span><span class='strut'>&nbsp;</span></p>
+<p id='t928' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>obj</span><span class='strut'>&nbsp;</span></p>
+<p id='t929' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span>&nbsp; <span class='com'># Trace ONLY!!!</span><span class='strut'>&nbsp;</span></p>
+<p id='t930' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyListEntryError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t931' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t932' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span><span class='op'>=</span><span class='nam'>index</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t933' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='str'>&quot;The entry could not be converted into a PlotlyTrace &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t934' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;object (e.g., Scatter, Heatmap, Bar, etc).&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t935' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t936' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>Data</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>caller</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
 <p id='t937' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t938' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t939' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t940' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Change any nested collections to subclasses of PlotlyDict/List.</span><span class='strut'>&nbsp;</span></p>
+<p id='t938' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t939' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Annotations</span><span class='op'>(</span><span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t940' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A list-like object to contain all figure notes.</span><span class='strut'>&nbsp;</span></p>
 <p id='t941' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t942' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Procedure:</span><span class='strut'>&nbsp;</span></p>
-<p id='t943' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 1. Attempt to convert all entries to a subclass of PlotlyDict.</span><span class='strut'>&nbsp;</span></p>
-<p id='t944' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2. Call `to_graph_objects` on each of these entries.</span><span class='strut'>&nbsp;</span></p>
+<p id='t942' class='pln'><span class='str'>&nbsp; &nbsp; Any operation that can be done with a standard list may be used with</span><span class='strut'>&nbsp;</span></p>
+<p id='t943' class='pln'><span class='str'>&nbsp; &nbsp; Annotations. Instantiation requires an iterable (just like list does),</span><span class='strut'>&nbsp;</span></p>
+<p id='t944' class='pln'><span class='str'>&nbsp; &nbsp; for example:</span><span class='strut'>&nbsp;</span></p>
 <p id='t945' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t946' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t947' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t948' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t949' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='nam'>Annotation</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t950' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyListEntryError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t951' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t952' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span><span class='op'>=</span><span class='nam'>index</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t953' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='str'>&quot;The entry could not be converted into an &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t954' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Annotation object because it was already a &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t955' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;different kind of graph object.&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t956' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t957' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t958' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span> <span class='op'>=</span> <span class='nam'>Annotation</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t959' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>k</span><span class='op'>,</span> <span class='nam'>v</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t960' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>[</span><span class='nam'>k</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>v</span><span class='strut'>&nbsp;</span></p>
-<p id='t961' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>obj</span><span class='strut'>&nbsp;</span></p>
-<p id='t962' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t963' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyListEntryError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t964' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t965' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span><span class='op'>=</span><span class='nam'>index</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t966' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='str'>&quot;The entry could not be converted into an Annotation &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t967' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;object because it was not a dictionary.&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t968' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t969' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>Annotations</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>caller</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t970' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t971' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t972' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>PlotlyTrace</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t973' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A general data class for plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t974' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t975' class='pln'><span class='str'>&nbsp; &nbsp; The PlotlyTrace object is not meant for user interaction. It&#39;s sole</span><span class='strut'>&nbsp;</span></p>
-<p id='t976' class='pln'><span class='str'>&nbsp; &nbsp; purpose is to improve the structure of the object hierarchy established</span><span class='strut'>&nbsp;</span></p>
-<p id='t977' class='pln'><span class='str'>&nbsp; &nbsp; in this module.</span><span class='strut'>&nbsp;</span></p>
-<p id='t978' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t979' class='pln'><span class='str'>&nbsp; &nbsp; Users should work with the subclasses of PlotlyTrace: Scatter, Box, Bar,</span><span class='strut'>&nbsp;</span></p>
-<p id='t980' class='pln'><span class='str'>&nbsp; &nbsp; Heatmap, etc.</span><span class='strut'>&nbsp;</span></p>
-<p id='t981' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t982' class='pln'><span class='str'>&nbsp; &nbsp; For help with these subclasses, run:</span><span class='strut'>&nbsp;</span></p>
-<p id='t983' class='pln'><span class='str'>&nbsp; &nbsp; `help(plotly.graph_objs.Obj)` where Obj == Scatter, Box, Bar, Heatmap, etc.</span><span class='strut'>&nbsp;</span></p>
-<p id='t984' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t985' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t986' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t987' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__init__</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t988' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span> <span class='op'>==</span> <span class='str'>&#39;PlotlyTrace&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t989' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;\nThe PlotlyTrace class is a base class of &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t990' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;dictionary-like plot types.\nIt is not meant to be &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t991' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;a user interface.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t992' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t993' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>level</span><span class='op'>=</span><span class='num'>0</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='num'>4</span><span class='op'>,</span> <span class='nam'>eol</span><span class='op'>=</span><span class='str'>&#39;\n&#39;</span><span class='op'>,</span> <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='nam'>max_chars</span><span class='op'>=</span><span class='num'>80</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t994' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns a formatted string showing graph_obj constructors.</span><span class='strut'>&nbsp;</span></p>
+<p id='t946' class='pln'><span class='str'>&nbsp; &nbsp; Annotations([Annotation(), Annotation(), Annotation()])</span><span class='strut'>&nbsp;</span></p>
+<p id='t947' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t948' class='pln'><span class='str'>&nbsp; &nbsp; This Annotations list is validated upon instantiation, meaning exceptions</span><span class='strut'>&nbsp;</span></p>
+<p id='t949' class='pln'><span class='str'>&nbsp; &nbsp; will be thrown if any invalid entries are found.</span><span class='strut'>&nbsp;</span></p>
+<p id='t950' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t951' class='pln'><span class='str'>&nbsp; &nbsp; Valid entry types: (dict or Annotation)</span><span class='strut'>&nbsp;</span></p>
+<p id='t952' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t953' class='pln'><span class='str'>&nbsp; &nbsp; For help on Annotation, run `help(plotly.graph_objs.Annotation)`</span><span class='strut'>&nbsp;</span></p>
+<p id='t954' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t955' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t956' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t957' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Change any nested collections to subclasses of PlotlyDict/List.</span><span class='strut'>&nbsp;</span></p>
+<p id='t958' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t959' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Procedure:</span><span class='strut'>&nbsp;</span></p>
+<p id='t960' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 1. Attempt to convert all entries to a subclass of PlotlyDict.</span><span class='strut'>&nbsp;</span></p>
+<p id='t961' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 2. Call `to_graph_objects` on each of these entries.</span><span class='strut'>&nbsp;</span></p>
+<p id='t962' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t963' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t964' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t965' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>,</span> <span class='nam'>PlotlyList</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t966' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='nam'>Annotation</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t967' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyListEntryError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t968' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t969' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span><span class='op'>=</span><span class='nam'>index</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t970' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='str'>&quot;The entry could not be converted into an &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t971' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Annotation object because it was already a &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t972' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;different kind of graph object.&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t973' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t974' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t975' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span> <span class='op'>=</span> <span class='nam'>Annotation</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t976' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>k</span><span class='op'>,</span> <span class='nam'>v</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t977' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>[</span><span class='nam'>k</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>v</span><span class='strut'>&nbsp;</span></p>
+<p id='t978' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>index</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>obj</span><span class='strut'>&nbsp;</span></p>
+<p id='t979' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t980' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyListEntryError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t981' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t982' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span><span class='op'>=</span><span class='nam'>index</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t983' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>notes</span><span class='op'>=</span><span class='str'>&quot;The entry could not be converted into an Annotation &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t984' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;object because it was not a dictionary.&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t985' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t986' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>Annotations</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>caller</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t987' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t988' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t989' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>PlotlyTrace</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t990' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A general data class for plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t991' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t992' class='pln'><span class='str'>&nbsp; &nbsp; The PlotlyTrace object is not meant for user interaction. It&#39;s sole</span><span class='strut'>&nbsp;</span></p>
+<p id='t993' class='pln'><span class='str'>&nbsp; &nbsp; purpose is to improve the structure of the object hierarchy established</span><span class='strut'>&nbsp;</span></p>
+<p id='t994' class='pln'><span class='str'>&nbsp; &nbsp; in this module.</span><span class='strut'>&nbsp;</span></p>
 <p id='t995' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t996' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t997' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t998' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; print obj.to_string()</span><span class='strut'>&nbsp;</span></p>
-<p id='t999' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1000' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1001' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; level (default = 0) -- set number of indentations to start with</span><span class='strut'>&nbsp;</span></p>
-<p id='t1002' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; indent (default = 4) -- set indentation amount</span><span class='strut'>&nbsp;</span></p>
-<p id='t1003' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; eol (default = &#39;\n&#39;) -- set end of line character(s)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1004' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; pretty (default = True) -- curtail long list output with a &#39;...&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1005' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; max_chars (default = 80) -- set max characters per line</span><span class='strut'>&nbsp;</span></p>
-<p id='t1006' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1007' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1008' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1009' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span> <span class='op'>!=</span> <span class='str'>&quot;Trace&quot;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1010' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>trace_type</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>pop</span><span class='op'>(</span><span class='str'>&#39;type&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1011' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>=</span> <span class='nam'>super</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>=</span><span class='nam'>level</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1012' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='nam'>indent</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1013' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1014' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>pretty</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1015' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>max_chars</span><span class='op'>=</span><span class='nam'>max_chars</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1016' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>trace_type</span><span class='strut'>&nbsp;</span></p>
-<p id='t1017' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1018' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>=</span> <span class='nam'>super</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>=</span><span class='nam'>level</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1019' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='nam'>indent</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1020' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1021' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>pretty</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1022' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>max_chars</span><span class='op'>=</span><span class='nam'>max_chars</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1023' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>string</span><span class='strut'>&nbsp;</span></p>
-<p id='t1024' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1025' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1026' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Trace</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1027' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A general data class for plotly. Never validated...</span><span class='strut'>&nbsp;</span></p>
-<p id='t1028' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1029' class='pln'><span class='str'>&nbsp; &nbsp; This class should be used only for the right reason. This class does not</span><span class='strut'>&nbsp;</span></p>
-<p id='t1030' class='pln'><span class='str'>&nbsp; &nbsp; do much validation because plotly usually accepts more trace specifiers</span><span class='strut'>&nbsp;</span></p>
-<p id='t1031' class='pln'><span class='str'>&nbsp; &nbsp; and more value type varieties, e.g., &#39;x&#39;, &#39;y&#39;, &#39;r&#39;, &#39;t&#39;, marker = [</span><span class='strut'>&nbsp;</span></p>
-<p id='t1032' class='pln'><span class='str'>&nbsp; &nbsp; array], etc.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1033' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1034' class='pln'><span class='str'>&nbsp; &nbsp; If you are getting errors locally, you might try using this case if</span><span class='strut'>&nbsp;</span></p>
-<p id='t1035' class='pln'><span class='str'>&nbsp; &nbsp; you&#39;re sure that what you&#39;re attempting to plot is valid.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1036' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1037' class='pln'><span class='str'>&nbsp; &nbsp; Also, when getting figures from plotly, you may get back `Trace` types if</span><span class='strut'>&nbsp;</span></p>
-<p id='t1038' class='pln'><span class='str'>&nbsp; &nbsp; the figure was constructed with data objects that don&#39;t fall into any of</span><span class='strut'>&nbsp;</span></p>
-<p id='t1039' class='pln'><span class='str'>&nbsp; &nbsp; the class categorizations that are defined in this api.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1040' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1041' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1042' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t1043' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1044' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1045' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Area</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1046' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing an area chart in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1047' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1048' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1049' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t996' class='pln'><span class='str'>&nbsp; &nbsp; Users should work with the subclasses of PlotlyTrace: Scatter, Box, Bar,</span><span class='strut'>&nbsp;</span></p>
+<p id='t997' class='pln'><span class='str'>&nbsp; &nbsp; Heatmap, etc.</span><span class='strut'>&nbsp;</span></p>
+<p id='t998' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t999' class='pln'><span class='str'>&nbsp; &nbsp; For help with these subclasses, run:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1000' class='pln'><span class='str'>&nbsp; &nbsp; `help(plotly.graph_objs.Obj)` where Obj == Scatter, Box, Bar, Heatmap, etc.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1001' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1002' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1003' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1004' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__init__</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1005' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span> <span class='op'>==</span> <span class='str'>&#39;PlotlyTrace&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1006' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;\nThe PlotlyTrace class is a base class of &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1007' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;dictionary-like plot types.\nIt is not meant to be &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1008' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;a user interface.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1009' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1010' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>level</span><span class='op'>=</span><span class='num'>0</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='num'>4</span><span class='op'>,</span> <span class='nam'>eol</span><span class='op'>=</span><span class='str'>&#39;\n&#39;</span><span class='op'>,</span> <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='nam'>max_chars</span><span class='op'>=</span><span class='num'>80</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1011' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns a formatted string showing graph_obj constructors.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1012' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1013' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1014' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1015' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; print obj.to_string()</span><span class='strut'>&nbsp;</span></p>
+<p id='t1016' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1017' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1018' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; level (default = 0) -- set number of indentations to start with</span><span class='strut'>&nbsp;</span></p>
+<p id='t1019' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; indent (default = 4) -- set indentation amount</span><span class='strut'>&nbsp;</span></p>
+<p id='t1020' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; eol (default = &#39;\n&#39;) -- set end of line character(s)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1021' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; pretty (default = True) -- curtail long list output with a &#39;...&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1022' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; max_chars (default = 80) -- set max characters per line</span><span class='strut'>&nbsp;</span></p>
+<p id='t1023' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1024' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1025' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1026' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span> <span class='op'>!=</span> <span class='str'>&quot;Trace&quot;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1027' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>trace_type</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>pop</span><span class='op'>(</span><span class='str'>&#39;type&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1028' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>=</span> <span class='nam'>super</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>=</span><span class='nam'>level</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1029' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='nam'>indent</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1030' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1031' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>pretty</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1032' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>max_chars</span><span class='op'>=</span><span class='nam'>max_chars</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1033' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>trace_type</span><span class='strut'>&nbsp;</span></p>
+<p id='t1034' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1035' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>=</span> <span class='nam'>super</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>=</span><span class='nam'>level</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1036' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='nam'>indent</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1037' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1038' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>pretty</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1039' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>max_chars</span><span class='op'>=</span><span class='nam'>max_chars</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1040' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>string</span><span class='strut'>&nbsp;</span></p>
+<p id='t1041' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1042' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1043' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Trace</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1044' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A general data class for plotly. Never validated...</span><span class='strut'>&nbsp;</span></p>
+<p id='t1045' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1046' class='pln'><span class='str'>&nbsp; &nbsp; This class should be used only for the right reason. This class does not</span><span class='strut'>&nbsp;</span></p>
+<p id='t1047' class='pln'><span class='str'>&nbsp; &nbsp; do much validation because plotly usually accepts more trace specifiers</span><span class='strut'>&nbsp;</span></p>
+<p id='t1048' class='pln'><span class='str'>&nbsp; &nbsp; and more value type varieties, e.g., &#39;x&#39;, &#39;y&#39;, &#39;r&#39;, &#39;t&#39;, marker = [</span><span class='strut'>&nbsp;</span></p>
+<p id='t1049' class='pln'><span class='str'>&nbsp; &nbsp; array], etc.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1050' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1051' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1052' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Bar</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1053' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a bar chart in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1054' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1055' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1056' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1057' class='pln'><span class='str'>&nbsp; &nbsp; py.plot([Bar(x=[&#39;yesterday&#39;, &#39;today&#39;, &#39;tomorrow&#39;], y=[5, 4, 10])])</span><span class='strut'>&nbsp;</span></p>
-<p id='t1058' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1059' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1060' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1051' class='pln'><span class='str'>&nbsp; &nbsp; If you are getting errors locally, you might try using this case if</span><span class='strut'>&nbsp;</span></p>
+<p id='t1052' class='pln'><span class='str'>&nbsp; &nbsp; you&#39;re sure that what you&#39;re attempting to plot is valid.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1053' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1054' class='pln'><span class='str'>&nbsp; &nbsp; Also, when getting figures from plotly, you may get back `Trace` types if</span><span class='strut'>&nbsp;</span></p>
+<p id='t1055' class='pln'><span class='str'>&nbsp; &nbsp; the figure was constructed with data objects that don&#39;t fall into any of</span><span class='strut'>&nbsp;</span></p>
+<p id='t1056' class='pln'><span class='str'>&nbsp; &nbsp; the class categorizations that are defined in this api.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1057' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1058' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1059' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1060' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1061' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1062' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1063' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Box</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1064' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a box plot in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1065' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1066' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1062' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Area</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1063' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing an area chart in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1064' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1065' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1066' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
 <p id='t1067' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1068' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.plot([Box(name=&#39;boxy&#39;, y=[1,3,9,2,4,2,3,5,2])])</span><span class='strut'>&nbsp;</span></p>
-<p id='t1069' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1070' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1071' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t1072' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1068' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1069' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Bar</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1070' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a bar chart in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1071' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1072' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
 <p id='t1073' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1074' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Contour</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1075' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a contour plot in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1076' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1077' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1074' class='pln'><span class='str'>&nbsp; &nbsp; py.plot([Bar(x=[&#39;yesterday&#39;, &#39;today&#39;, &#39;tomorrow&#39;], y=[5, 4, 10])])</span><span class='strut'>&nbsp;</span></p>
+<p id='t1075' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1076' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1077' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
 <p id='t1078' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1079' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; z = [[0, 1, 0, 1, 0],</span><span class='strut'>&nbsp;</span></p>
-<p id='t1080' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; [1, 0, 1, 0, 1],</span><span class='strut'>&nbsp;</span></p>
-<p id='t1081' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; [0, 1, 0, 1, 0],]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1082' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; y = [&#39;a&#39;, &#39;b&#39;, &#39;c&#39;]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1083' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; x = [1, 2, 3, 4, 5]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1084' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.plot([Contour(z=z, x=x, y=y)])</span><span class='strut'>&nbsp;</span></p>
-<p id='t1085' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1086' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1087' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t1088' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1079' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1080' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Box</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1081' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a box plot in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1082' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1083' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1084' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1085' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.plot([Box(name=&#39;boxy&#39;, y=[1,3,9,2,4,2,3,5,2])])</span><span class='strut'>&nbsp;</span></p>
+<p id='t1086' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1087' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1088' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
 <p id='t1089' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1090' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Heatmap</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1091' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a heatmap in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1092' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1093' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1094' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1095' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; z = [[0, 1, 0, 1, 0],</span><span class='strut'>&nbsp;</span></p>
-<p id='t1096' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; [1, 0, 1, 0, 1],</span><span class='strut'>&nbsp;</span></p>
-<p id='t1097' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; [0, 1, 0, 1, 0],]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1098' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; y = [&#39;a&#39;, &#39;b&#39;, &#39;c&#39;]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1099' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; x = [1, 2, 3, 4, 5]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1100' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.plot([Heatmap(z=z, x=x, y=y)])</span><span class='strut'>&nbsp;</span></p>
-<p id='t1101' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1102' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1103' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t1104' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1090' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1091' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Contour</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1092' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a contour plot in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1093' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1094' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1095' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1096' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; z = [[0, 1, 0, 1, 0],</span><span class='strut'>&nbsp;</span></p>
+<p id='t1097' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; [1, 0, 1, 0, 1],</span><span class='strut'>&nbsp;</span></p>
+<p id='t1098' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; [0, 1, 0, 1, 0],]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1099' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; y = [&#39;a&#39;, &#39;b&#39;, &#39;c&#39;]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1100' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; x = [1, 2, 3, 4, 5]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1101' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.plot([Contour(z=z, x=x, y=y)])</span><span class='strut'>&nbsp;</span></p>
+<p id='t1102' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1103' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1104' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
 <p id='t1105' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1106' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Histogram</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1107' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a histogram plot in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1108' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1109' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1110' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; # make a histogram along xaxis...</span><span class='strut'>&nbsp;</span></p>
-<p id='t1111' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.plot([Histogram(x=[1,1,2,3,2,3,3])])</span><span class='strut'>&nbsp;</span></p>
-<p id='t1112' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1113' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; # make a histogram along yaxis...</span><span class='strut'>&nbsp;</span></p>
-<p id='t1114' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.plot([Histogram(y=[1,1,2,3,2,3,3], orientation=&#39;h&#39;)])</span><span class='strut'>&nbsp;</span></p>
-<p id='t1115' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1116' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1117' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1106' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1107' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Heatmap</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1108' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a heatmap in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1109' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1110' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1111' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1112' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; z = [[0, 1, 0, 1, 0],</span><span class='strut'>&nbsp;</span></p>
+<p id='t1113' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; [1, 0, 1, 0, 1],</span><span class='strut'>&nbsp;</span></p>
+<p id='t1114' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; [0, 1, 0, 1, 0],]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1115' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; y = [&#39;a&#39;, &#39;b&#39;, &#39;c&#39;]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1116' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; x = [1, 2, 3, 4, 5]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1117' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.plot([Heatmap(z=z, x=x, y=y)])</span><span class='strut'>&nbsp;</span></p>
 <p id='t1118' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1119' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Histogram2d</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1120' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a histogram2d plot in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1119' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1120' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
 <p id='t1121' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1122' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1123' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1124' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; import numpy as np</span><span class='strut'>&nbsp;</span></p>
-<p id='t1125' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; x = np.random.randn(500)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1126' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; y = np.random.randn(500)+1</span><span class='strut'>&nbsp;</span></p>
-<p id='t1127' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.iplot([Histogram2d(x=x, y=y)])</span><span class='strut'>&nbsp;</span></p>
-<p id='t1128' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1129' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1130' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t1131' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1122' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1123' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Histogram</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1124' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a histogram plot in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1125' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1126' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1127' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; # make a histogram along xaxis...</span><span class='strut'>&nbsp;</span></p>
+<p id='t1128' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.plot([Histogram(x=[1,1,2,3,2,3,3])])</span><span class='strut'>&nbsp;</span></p>
+<p id='t1129' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1130' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; # make a histogram along yaxis...</span><span class='strut'>&nbsp;</span></p>
+<p id='t1131' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.plot([Histogram(y=[1,1,2,3,2,3,3], orientation=&#39;h&#39;)])</span><span class='strut'>&nbsp;</span></p>
 <p id='t1132' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1133' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Histogram2dContour</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1134' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dict-like object for representing a histogram2d-contour plot in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1133' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1134' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1135' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1136' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1137' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1138' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; import numpy as np</span><span class='strut'>&nbsp;</span></p>
-<p id='t1139' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; x = np.random.randn(500)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1140' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; y = np.random.randn(500)+1</span><span class='strut'>&nbsp;</span></p>
-<p id='t1141' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.iplot([Histogram2dcountour(x=x, y=y)])</span><span class='strut'>&nbsp;</span></p>
-<p id='t1142' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1143' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1144' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1136' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Histogram2d</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1137' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a histogram2d plot in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1138' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1139' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1140' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1141' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; import numpy as np</span><span class='strut'>&nbsp;</span></p>
+<p id='t1142' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; x = np.random.randn(500)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1143' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; y = np.random.randn(500)+1</span><span class='strut'>&nbsp;</span></p>
+<p id='t1144' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.iplot([Histogram2d(x=x, y=y)])</span><span class='strut'>&nbsp;</span></p>
 <p id='t1145' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1146' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1147' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Scatter</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1148' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a scatter plot in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1146' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1147' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1148' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1149' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1150' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1151' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1152' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.plot([Scatter(name=&#39;tacters&#39;, x=[1,4,2,3], y=[1,6,2,1])])</span><span class='strut'>&nbsp;</span></p>
-<p id='t1153' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1154' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1155' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t1156' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1157' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1158' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>AngularAxis</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1159' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A&nbsp; dictionary-like object for representing an angular axis in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1160' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1161' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1162' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1150' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Histogram2dContour</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1151' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dict-like object for representing a histogram2d-contour plot in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1152' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1153' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1154' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1155' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; import numpy as np</span><span class='strut'>&nbsp;</span></p>
+<p id='t1156' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; x = np.random.randn(500)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1157' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; y = np.random.randn(500)+1</span><span class='strut'>&nbsp;</span></p>
+<p id='t1158' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.iplot([Histogram2dcountour(x=x, y=y)])</span><span class='strut'>&nbsp;</span></p>
+<p id='t1159' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1160' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1161' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1162' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1163' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1164' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1165' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>RadialAxis</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1166' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A&nbsp; dictionary-like object for representing an angular axis in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1167' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1168' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1169' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1164' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Scatter</span><span class='op'>(</span><span class='nam'>PlotlyTrace</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1165' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a scatter plot in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1166' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1167' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1168' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1169' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; py.plot([Scatter(name=&#39;tacters&#39;, x=[1,4,2,3], y=[1,6,2,1])])</span><span class='strut'>&nbsp;</span></p>
 <p id='t1170' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1171' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1172' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Annotation</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1173' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing an annotation in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1171' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1172' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1173' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1174' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1175' class='pln'><span class='str'>&nbsp; &nbsp; Annotations appear as notes on the final figure. You can set all the</span><span class='strut'>&nbsp;</span></p>
-<p id='t1176' class='pln'><span class='str'>&nbsp; &nbsp; features of the annotation text, background color, and location.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1177' class='pln'><span class='str'>&nbsp; &nbsp; Additionally, these notes can be anchored to actual data or the page for</span><span class='strut'>&nbsp;</span></p>
-<p id='t1178' class='pln'><span class='str'>&nbsp; &nbsp; help with location after pan-and-zoom actions.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1179' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1180' class='pln'><span class='str'>&nbsp; &nbsp; This object is validated upon instantiation, therefore, you may see</span><span class='strut'>&nbsp;</span></p>
-<p id='t1181' class='pln'><span class='str'>&nbsp; &nbsp; exceptions getting thrown. These are intended to help users find the</span><span class='strut'>&nbsp;</span></p>
-<p id='t1182' class='pln'><span class='str'>&nbsp; &nbsp; origin of errors faster. The errors will usually contain information that</span><span class='strut'>&nbsp;</span></p>
-<p id='t1183' class='pln'><span class='str'>&nbsp; &nbsp; can be used to remedy the problem.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1175' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>AngularAxis</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1176' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A&nbsp; dictionary-like object for representing an angular axis in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1177' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1178' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1179' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1180' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1181' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1182' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>RadialAxis</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1183' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A&nbsp; dictionary-like object for representing an angular axis in plotly.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1184' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1185' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1186' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1187' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; note = Annotation(text=&#39;what i want this to say is:&lt;br&gt;THIS!&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1188' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; x=0,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1189' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; y=0,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1190' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; xref=&#39;paper&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1191' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; yref=&#39;paper,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1192' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; yanchor=&#39;bottom&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1193' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; xanchor=&#39;left&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1194' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1195' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1196' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t1197' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1198' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1199' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>ColorBar</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: ?</span><span class='strut'>&nbsp;</span></p>
-<p id='t1200' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a color bar in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1185' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1186' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1187' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1188' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1189' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Annotation</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1190' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing an annotation in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1191' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1192' class='pln'><span class='str'>&nbsp; &nbsp; Annotations appear as notes on the final figure. You can set all the</span><span class='strut'>&nbsp;</span></p>
+<p id='t1193' class='pln'><span class='str'>&nbsp; &nbsp; features of the annotation text, background color, and location.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1194' class='pln'><span class='str'>&nbsp; &nbsp; Additionally, these notes can be anchored to actual data or the page for</span><span class='strut'>&nbsp;</span></p>
+<p id='t1195' class='pln'><span class='str'>&nbsp; &nbsp; help with location after pan-and-zoom actions.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1196' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1197' class='pln'><span class='str'>&nbsp; &nbsp; This object is validated upon instantiation, therefore, you may see</span><span class='strut'>&nbsp;</span></p>
+<p id='t1198' class='pln'><span class='str'>&nbsp; &nbsp; exceptions getting thrown. These are intended to help users find the</span><span class='strut'>&nbsp;</span></p>
+<p id='t1199' class='pln'><span class='str'>&nbsp; &nbsp; origin of errors faster. The errors will usually contain information that</span><span class='strut'>&nbsp;</span></p>
+<p id='t1200' class='pln'><span class='str'>&nbsp; &nbsp; can be used to remedy the problem.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1201' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1202' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1203' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t1204' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1205' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1206' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Contours</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: ?</span><span class='strut'>&nbsp;</span></p>
-<p id='t1207' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a contours object in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1208' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1209' class='pln'><span class='str'>&nbsp; &nbsp; This object exists inside definitions for a contour plot.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1210' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1211' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1212' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1213' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>ErrorX</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1214' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a set of errorx bars in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1202' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1203' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1204' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; note = Annotation(text=&#39;what i want this to say is:&lt;br&gt;THIS!&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1205' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; x=0,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1206' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; y=0,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1207' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; xref=&#39;paper&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1208' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; yref=&#39;paper,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1209' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; yanchor=&#39;bottom&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1210' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; xanchor=&#39;left&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1211' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1212' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1213' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1214' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1215' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1216' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1217' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1216' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>ColorBar</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: ?</span><span class='strut'>&nbsp;</span></p>
+<p id='t1217' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a color bar in plotly.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1218' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1219' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1220' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>ErrorY</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1221' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a set of errory bars in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1219' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1220' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1221' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1222' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1223' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1224' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1223' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Contours</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: ?</span><span class='strut'>&nbsp;</span></p>
+<p id='t1224' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a contours object in plotly.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1225' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1226' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1227' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Figure</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1228' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing a figure to be rendered in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1226' class='pln'><span class='str'>&nbsp; &nbsp; This object exists inside definitions for a contour plot.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1227' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1228' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
 <p id='t1229' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1230' class='pln'><span class='str'>&nbsp; &nbsp; This is the container for all things to be rendered in a figure.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1231' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1232' class='pln'><span class='str'>&nbsp; &nbsp; For help with setting up subplots, run:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1233' class='pln'><span class='str'>&nbsp; &nbsp; `help(plotly.tools.get_subplots)`</span><span class='strut'>&nbsp;</span></p>
-<p id='t1234' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1235' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1236' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1237' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>args</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1238' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;data&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>kwargs</span><span class='op'>)</span> <span class='key'>and</span> <span class='op'>(</span><span class='str'>&#39;data&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>args</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1239' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>kwargs</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>Data</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1240' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;layout&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>kwargs</span><span class='op'>)</span> <span class='key'>and</span> <span class='op'>(</span><span class='str'>&#39;layout&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>args</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1241' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>kwargs</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>Layout</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1242' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1243' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;data&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>kwargs</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1244' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>kwargs</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>Data</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1245' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;layout&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>kwargs</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1246' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>kwargs</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>Layout</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1247' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>Figure</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__init__</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1230' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>ErrorX</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1231' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a set of errorx bars in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1232' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1233' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1234' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1235' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1236' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1237' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>ErrorY</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1238' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object for representing a set of errory bars in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1239' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1240' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1241' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1242' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1243' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1244' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Figure</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1245' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing a figure to be rendered in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1246' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1247' class='pln'><span class='str'>&nbsp; &nbsp; This is the container for all things to be rendered in a figure.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1248' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1249' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1250' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Font</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1251' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing details about font style.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1252' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1253' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1254' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t1255' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1256' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1257' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Layout</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1258' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object holding plot settings for plotly figures.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1259' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1260' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1261' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1262' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>Layout</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__init__</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1263' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1264' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1265' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Walk obj, convert dicts and lists to plotly graph objs.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1249' class='pln'><span class='str'>&nbsp; &nbsp; For help with setting up subplots, run:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1250' class='pln'><span class='str'>&nbsp; &nbsp; `help(plotly.tools.get_subplots)`</span><span class='strut'>&nbsp;</span></p>
+<p id='t1251' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1252' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1253' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1254' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>args</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1255' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;data&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>kwargs</span><span class='op'>)</span> <span class='key'>and</span> <span class='op'>(</span><span class='str'>&#39;data&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>args</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1256' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>kwargs</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>Data</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1257' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;layout&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>kwargs</span><span class='op'>)</span> <span class='key'>and</span> <span class='op'>(</span><span class='str'>&#39;layout&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>args</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1258' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>kwargs</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>Layout</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1259' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1260' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;data&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>kwargs</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1261' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>kwargs</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>Data</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1262' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;layout&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>kwargs</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1263' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>kwargs</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>Layout</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1264' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>Figure</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__init__</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1265' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1266' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1267' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; For each key in the object, if it corresponds to a special key that</span><span class='strut'>&nbsp;</span></p>
-<p id='t1268' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; should be associated with a graph object, the ordinary dict or list</span><span class='strut'>&nbsp;</span></p>
-<p id='t1269' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; will be reinitialized as a special PlotlyDict or PlotlyList of the</span><span class='strut'>&nbsp;</span></p>
-<p id='t1270' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; appropriate `kind`.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1271' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1272' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1273' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>keys</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1274' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1275' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span><span class='op'>[</span><span class='op'>:</span><span class='num'>5</span><span class='op'>]</span> <span class='key'>in</span> <span class='op'>[</span><span class='str'>&#39;xaxis&#39;</span><span class='op'>,</span> <span class='str'>&#39;yaxis&#39;</span><span class='op'>]</span><span class='op'>:</span>&nbsp; <span class='com'># allows appended integers!</span><span class='strut'>&nbsp;</span></p>
-<p id='t1276' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1277' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>axis_int</span> <span class='op'>=</span> <span class='nam'>int</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>[</span><span class='num'>5</span><span class='op'>:</span><span class='op'>]</span><span class='op'>)</span>&nbsp; <span class='com'># may raise ValueError</span><span class='strut'>&nbsp;</span></p>
-<p id='t1278' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>axis_int</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1279' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>continue</span>&nbsp; <span class='com'># xaxis0 and yaxis0 are not valid keys...</span><span class='strut'>&nbsp;</span></p>
-<p id='t1280' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>ValueError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1281' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>continue</span>&nbsp; <span class='com'># not an XAxis or YAxis object after all</span><span class='strut'>&nbsp;</span></p>
-<p id='t1282' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1283' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span><span class='op'>[</span><span class='op'>:</span><span class='num'>5</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;xaxis&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1284' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span> <span class='op'>=</span> <span class='nam'>XAxis</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1285' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1286' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span> <span class='op'>=</span> <span class='nam'>YAxis</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1287' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>k</span><span class='op'>,</span> <span class='nam'>v</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>pop</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1288' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>[</span><span class='nam'>k</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>v</span><span class='strut'>&nbsp;</span></p>
-<p id='t1289' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>obj</span>&nbsp; <span class='com'># call to super will call &#39;to_graph_objs&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1290' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>Layout</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>caller</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1291' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1292' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>level</span><span class='op'>=</span><span class='num'>0</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='num'>4</span><span class='op'>,</span> <span class='nam'>eol</span><span class='op'>=</span><span class='str'>&#39;\n&#39;</span><span class='op'>,</span> <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='nam'>max_chars</span><span class='op'>=</span><span class='num'>80</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1293' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns a formatted string showing graph_obj constructors.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1294' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1295' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1296' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1297' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; print obj.to_string()</span><span class='strut'>&nbsp;</span></p>
-<p id='t1298' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1299' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1300' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; level (default = 0) -- set number of indentations to start with</span><span class='strut'>&nbsp;</span></p>
-<p id='t1301' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; indent (default = 4) -- set indentation amount</span><span class='strut'>&nbsp;</span></p>
-<p id='t1302' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; eol (default = &#39;\n&#39;) -- set end of line character(s)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1303' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; pretty (default = True) -- curtail long list output with a &#39;...&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1304' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; max_chars (default = 80) -- set max characters per line</span><span class='strut'>&nbsp;</span></p>
-<p id='t1305' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1306' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1307' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># TODO: can&#39;t call super</span><span class='strut'>&nbsp;</span></p>
-<p id='t1308' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1309' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1310' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='str'>&quot;{name}()&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1311' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>=</span> <span class='str'>&quot;{name}(&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1312' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span> <span class='op'>=</span> <span class='num'>0</span><span class='strut'>&nbsp;</span></p>
-<p id='t1313' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1314' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1315' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1316' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;{eol}{indent}{key}=&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t1317' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1318' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1319' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1320' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1321' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>=</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1322' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='nam'>indent</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1323' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1324' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>pretty</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1325' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>max_chars</span><span class='op'>=</span><span class='nam'>max_chars</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1326' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1327' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val</span> <span class='op'>=</span> <span class='nam'>repr</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1328' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_chars</span> <span class='op'>=</span> <span class='nam'>max_chars</span> <span class='op'>-</span> <span class='op'>(</span><span class='nam'>indent</span><span class='op'>*</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>-</span> <span class='op'>(</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1329' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>pretty</span> <span class='key'>and</span> <span class='op'>(</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>)</span> <span class='op'>&gt;</span> <span class='nam'>val_chars</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1330' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>val</span><span class='op'>[</span><span class='op'>:</span><span class='nam'>val_chars</span> <span class='op'>-</span> <span class='num'>5</span><span class='op'>]</span> <span class='op'>+</span> <span class='str'>&#39;...&#39;</span> <span class='op'>+</span> <span class='nam'>val</span><span class='op'>[</span><span class='op'>-</span><span class='num'>1</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1331' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1332' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
-<p id='t1333' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>index</span> <span class='op'>&lt;</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span> <span class='op'>-</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1334' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;,&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1335' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
-<p id='t1336' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>index</span> <span class='op'>==</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1337' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>break</span><span class='strut'>&nbsp;</span></p>
-<p id='t1338' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>left_over_keys</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>key</span> <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span> <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1339' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>left_over_keys</span><span class='op'>.</span><span class='nam'>sort</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1340' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>left_over_keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1341' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;{eol}{indent}{key}=&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t1342' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1343' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1344' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1345' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1346' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>=</span><span class='nam'>level</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1347' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='nam'>indent</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1348' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1349' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>pretty</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1350' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>max_chars</span><span class='op'>=</span><span class='nam'>max_chars</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1351' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1352' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>repr</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1353' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>index</span> <span class='op'>&lt;</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span> <span class='op'>-</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1354' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;,&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1355' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
-<p id='t1356' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;{eol}{indent})&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='nam'>level</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1357' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>string</span><span class='strut'>&nbsp;</span></p>
-<p id='t1358' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1359' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>force_clean</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: can&#39;t make call to super...</span><span class='strut'>&nbsp;</span></p>
-<p id='t1360' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Attempts to convert to graph_objs and call force_clean() on values.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1361' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1362' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Calling force_clean() on a Layout will ensure that the object is</span><span class='strut'>&nbsp;</span></p>
-<p id='t1363' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; valid and may be sent to plotly. This process will also remove any</span><span class='strut'>&nbsp;</span></p>
-<p id='t1364' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; entries that end up with a length == 0.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1365' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1366' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Careful! This will delete any invalid entries *silently*.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1367' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1368' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This method differs from the parent (PlotlyDict) method in that it</span><span class='strut'>&nbsp;</span></p>
-<p id='t1369' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; must check for an infinite number of possible axis keys, i.e. &#39;xaxis&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1370' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;xaxis1&#39;, &#39;xaxis2&#39;, &#39;xaxis3&#39;, etc. Therefore, it cannot make a call</span><span class='strut'>&nbsp;</span></p>
-<p id='t1371' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; to super...</span><span class='strut'>&nbsp;</span></p>
-<p id='t1372' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1373' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1374' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1375' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1376' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1377' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_keys</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>key</span> <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span> <span class='key'>if</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1378' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>del_keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1379' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='nam'>key</span><span class='op'>[</span><span class='op'>:</span><span class='num'>5</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;xaxis&#39;</span><span class='op'>)</span> <span class='key'>or</span> <span class='op'>(</span><span class='nam'>key</span><span class='op'>[</span><span class='op'>:</span><span class='num'>5</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;yaxis&#39;</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1380' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1381' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>test_if_int</span> <span class='op'>=</span> <span class='nam'>int</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>[</span><span class='num'>5</span><span class='op'>:</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1382' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>ValueError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1383' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1384' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1385' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1386' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>keys</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1387' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1388' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1389' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>force_clean</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span>&nbsp; <span class='com'># TODO error handling??</span><span class='strut'>&nbsp;</span></p>
-<p id='t1390' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1391' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t1392' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>dict</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1393' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1394' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span>&nbsp; <span class='com'># clears empty collections!</span><span class='strut'>&nbsp;</span></p>
-<p id='t1395' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='key'>is</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1396' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t1397' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1398' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1399' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Legend</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1400' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing the legend options for a figure.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1401' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1402' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1403' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t1404' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1405' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1406' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Line</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1407' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing the style of a line in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t1408' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1409' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1410' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t1411' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1412' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1413' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Marker</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1414' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing marker(s) style in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1267' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Font</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1268' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing details about font style.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1269' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1270' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1271' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1272' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1273' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1274' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Layout</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1275' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object holding plot settings for plotly figures.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1276' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1277' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1278' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1279' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>Layout</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>__init__</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1280' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1281' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1282' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Walk obj, convert dicts and lists to plotly graph objs.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1283' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1284' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; For each key in the object, if it corresponds to a special key that</span><span class='strut'>&nbsp;</span></p>
+<p id='t1285' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; should be associated with a graph object, the ordinary dict or list</span><span class='strut'>&nbsp;</span></p>
+<p id='t1286' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; will be reinitialized as a special PlotlyDict or PlotlyList of the</span><span class='strut'>&nbsp;</span></p>
+<p id='t1287' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; appropriate `kind`.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1288' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1289' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1290' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>keys</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1291' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1292' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span><span class='op'>[</span><span class='op'>:</span><span class='num'>5</span><span class='op'>]</span> <span class='key'>in</span> <span class='op'>[</span><span class='str'>&#39;xaxis&#39;</span><span class='op'>,</span> <span class='str'>&#39;yaxis&#39;</span><span class='op'>]</span><span class='op'>:</span>&nbsp; <span class='com'># allows appended integers!</span><span class='strut'>&nbsp;</span></p>
+<p id='t1293' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1294' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>axis_int</span> <span class='op'>=</span> <span class='nam'>int</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>[</span><span class='num'>5</span><span class='op'>:</span><span class='op'>]</span><span class='op'>)</span>&nbsp; <span class='com'># may raise ValueError</span><span class='strut'>&nbsp;</span></p>
+<p id='t1295' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>axis_int</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1296' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>continue</span>&nbsp; <span class='com'># xaxis0 and yaxis0 are not valid keys...</span><span class='strut'>&nbsp;</span></p>
+<p id='t1297' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>ValueError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1298' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>continue</span>&nbsp; <span class='com'># not an XAxis or YAxis object after all</span><span class='strut'>&nbsp;</span></p>
+<p id='t1299' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1300' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span><span class='op'>[</span><span class='op'>:</span><span class='num'>5</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;xaxis&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1301' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span> <span class='op'>=</span> <span class='nam'>XAxis</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1302' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1303' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span> <span class='op'>=</span> <span class='nam'>YAxis</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1304' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>k</span><span class='op'>,</span> <span class='nam'>v</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>pop</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1305' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj</span><span class='op'>[</span><span class='nam'>k</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>v</span><span class='strut'>&nbsp;</span></p>
+<p id='t1306' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>obj</span>&nbsp; <span class='com'># call to super will call &#39;to_graph_objs&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1307' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>super</span><span class='op'>(</span><span class='nam'>Layout</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>caller</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1308' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1309' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>level</span><span class='op'>=</span><span class='num'>0</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='num'>4</span><span class='op'>,</span> <span class='nam'>eol</span><span class='op'>=</span><span class='str'>&#39;\n&#39;</span><span class='op'>,</span> <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='nam'>max_chars</span><span class='op'>=</span><span class='num'>80</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1310' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns a formatted string showing graph_obj constructors.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1311' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1312' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1313' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1314' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; print obj.to_string()</span><span class='strut'>&nbsp;</span></p>
+<p id='t1315' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1316' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1317' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; level (default = 0) -- set number of indentations to start with</span><span class='strut'>&nbsp;</span></p>
+<p id='t1318' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; indent (default = 4) -- set indentation amount</span><span class='strut'>&nbsp;</span></p>
+<p id='t1319' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; eol (default = &#39;\n&#39;) -- set end of line character(s)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1320' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; pretty (default = True) -- curtail long list output with a &#39;...&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1321' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; max_chars (default = 80) -- set max characters per line</span><span class='strut'>&nbsp;</span></p>
+<p id='t1322' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1323' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1324' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># TODO: can&#39;t call super</span><span class='strut'>&nbsp;</span></p>
+<p id='t1325' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1326' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1327' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='str'>&quot;{name}()&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1328' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>=</span> <span class='str'>&quot;{name}(&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>name</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1329' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span> <span class='op'>=</span> <span class='num'>0</span><span class='strut'>&nbsp;</span></p>
+<p id='t1330' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1331' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1332' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1333' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;{eol}{indent}{key}=&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t1334' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1335' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1336' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1337' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1338' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>=</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1339' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='nam'>indent</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1340' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1341' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>pretty</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1342' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>max_chars</span><span class='op'>=</span><span class='nam'>max_chars</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1343' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1344' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val</span> <span class='op'>=</span> <span class='nam'>repr</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1345' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>val_chars</span> <span class='op'>=</span> <span class='nam'>max_chars</span> <span class='op'>-</span> <span class='op'>(</span><span class='nam'>indent</span><span class='op'>*</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>-</span> <span class='op'>(</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1346' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>pretty</span> <span class='key'>and</span> <span class='op'>(</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>)</span> <span class='op'>&gt;</span> <span class='nam'>val_chars</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1347' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>val</span><span class='op'>[</span><span class='op'>:</span><span class='nam'>val_chars</span> <span class='op'>-</span> <span class='num'>5</span><span class='op'>]</span> <span class='op'>+</span> <span class='str'>&#39;...&#39;</span> <span class='op'>+</span> <span class='nam'>val</span><span class='op'>[</span><span class='op'>-</span><span class='num'>1</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1348' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1349' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
+<p id='t1350' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>index</span> <span class='op'>&lt;</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span> <span class='op'>-</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1351' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;,&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1352' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
+<p id='t1353' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>index</span> <span class='op'>==</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1354' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>break</span><span class='strut'>&nbsp;</span></p>
+<p id='t1355' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>left_over_keys</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>key</span> <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span> <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1356' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>left_over_keys</span><span class='op'>.</span><span class='nam'>sort</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1357' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>left_over_keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1358' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;{eol}{indent}{key}=&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t1359' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1360' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>level</span><span class='op'>+</span><span class='num'>1</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1361' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1362' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1363' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>to_string</span><span class='op'>(</span><span class='nam'>level</span><span class='op'>=</span><span class='nam'>level</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1364' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>indent</span><span class='op'>=</span><span class='nam'>indent</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1365' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1366' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pretty</span><span class='op'>=</span><span class='nam'>pretty</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1367' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>max_chars</span><span class='op'>=</span><span class='nam'>max_chars</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1368' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1369' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>repr</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1370' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>index</span> <span class='op'>&lt;</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span> <span class='op'>-</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1371' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;,&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1372' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>index</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
+<p id='t1373' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>string</span> <span class='op'>+=</span> <span class='str'>&quot;{eol}{indent})&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>eol</span><span class='op'>=</span><span class='nam'>eol</span><span class='op'>,</span> <span class='nam'>indent</span><span class='op'>=</span><span class='str'>&#39; &#39;</span> <span class='op'>*</span> <span class='nam'>indent</span> <span class='op'>*</span> <span class='nam'>level</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1374' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>string</span><span class='strut'>&nbsp;</span></p>
+<p id='t1375' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1376' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>force_clean</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>caller</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: can&#39;t make call to super...</span><span class='strut'>&nbsp;</span></p>
+<p id='t1377' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Attempts to convert to graph_objs and call force_clean() on values.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1378' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1379' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Calling force_clean() on a Layout will ensure that the object is</span><span class='strut'>&nbsp;</span></p>
+<p id='t1380' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; valid and may be sent to plotly. This process will also remove any</span><span class='strut'>&nbsp;</span></p>
+<p id='t1381' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; entries that end up with a length == 0.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1382' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1383' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Careful! This will delete any invalid entries *silently*.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1384' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1385' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This method differs from the parent (PlotlyDict) method in that it</span><span class='strut'>&nbsp;</span></p>
+<p id='t1386' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; must check for an infinite number of possible axis keys, i.e. &#39;xaxis&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1387' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;xaxis1&#39;, &#39;xaxis2&#39;, &#39;xaxis3&#39;, etc. Therefore, it cannot make a call</span><span class='strut'>&nbsp;</span></p>
+<p id='t1388' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; to super...</span><span class='strut'>&nbsp;</span></p>
+<p id='t1389' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1390' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1391' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_key</span> <span class='op'>=</span> <span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1392' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>caller</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1393' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>to_graph_objs</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1394' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>del_keys</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>key</span> <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>self</span> <span class='key'>if</span> <span class='nam'>str</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>)</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>obj_key</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1395' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>del_keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1396' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='nam'>key</span><span class='op'>[</span><span class='op'>:</span><span class='num'>5</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;xaxis&#39;</span><span class='op'>)</span> <span class='key'>or</span> <span class='op'>(</span><span class='nam'>key</span><span class='op'>[</span><span class='op'>:</span><span class='num'>5</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;yaxis&#39;</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1397' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1398' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>test_if_int</span> <span class='op'>=</span> <span class='nam'>int</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>[</span><span class='num'>5</span><span class='op'>:</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1399' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>ValueError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1400' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1401' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1402' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1403' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>keys</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1404' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1405' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1406' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>force_clean</span><span class='op'>(</span><span class='nam'>caller</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span>&nbsp; <span class='com'># TODO error handling??</span><span class='strut'>&nbsp;</span></p>
+<p id='t1407' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1408' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1409' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>dict</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1410' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1411' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span>&nbsp; <span class='com'># clears empty collections!</span><span class='strut'>&nbsp;</span></p>
+<p id='t1412' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='key'>is</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1413' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t1414' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1415' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1416' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1417' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1416' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Legend</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1417' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing the legend options for a figure.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1418' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1419' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1420' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Margin</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1421' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object holding plot margin information.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1419' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1420' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1421' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1422' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1423' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1424' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1423' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Line</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1424' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing the style of a line in plotly.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1425' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1426' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1427' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Stream</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1428' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing a data stream.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1426' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1427' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1428' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1429' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1430' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1431' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1430' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Marker</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1431' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing marker(s) style in plotly.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1432' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1433' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1434' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>XAxis</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1435' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing an xaxis in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1433' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1434' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1435' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1436' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1437' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1438' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1437' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Margin</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1438' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object holding plot margin information.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1439' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1440' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1441' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>XBins</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1442' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing bin information for a histogram.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1440' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1441' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1442' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1443' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1444' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1445' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1444' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>Stream</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1445' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing a data stream.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1446' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1447' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1448' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>YAxis</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1449' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing a yaxis in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1447' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1448' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1449' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1450' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1451' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1452' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1451' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>XAxis</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1452' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing an xaxis in plotly.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1453' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1454' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1455' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>YBins</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t1456' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing bin information for a histogram.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1454' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1455' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1456' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t1457' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1458' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t1459' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1458' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>XBins</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1459' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing bin information for a histogram.</span><span class='strut'>&nbsp;</span></p>
 <p id='t1460' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t1461' class='pln'><span class='com'># finally... define how to map from a class name to an actual class</span><span class='strut'>&nbsp;</span></p>
-<p id='t1462' class='pln'><span class='com'># mapping: (n-&gt;n)</span><span class='strut'>&nbsp;</span></p>
-<p id='t1463' class='stm run hide_run'><span class='nam'>NAME_TO_CLASS</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t1464' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>PlotlyList</span><span class='op'>=</span><span class='nam'>PlotlyList</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1465' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Data</span><span class='op'>=</span><span class='nam'>Data</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1466' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Annotations</span><span class='op'>=</span><span class='nam'>Annotations</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1467' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>PlotlyDict</span><span class='op'>=</span><span class='nam'>PlotlyDict</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1468' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>PlotlyTrace</span><span class='op'>=</span><span class='nam'>PlotlyTrace</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1469' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Area</span><span class='op'>=</span><span class='nam'>Area</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1470' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Bar</span><span class='op'>=</span><span class='nam'>Bar</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1471' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Box</span><span class='op'>=</span><span class='nam'>Box</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1472' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Contour</span><span class='op'>=</span><span class='nam'>Contour</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1473' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Heatmap</span><span class='op'>=</span><span class='nam'>Heatmap</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1474' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Histogram</span><span class='op'>=</span><span class='nam'>Histogram</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1475' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Histogram2d</span><span class='op'>=</span><span class='nam'>Histogram2d</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1476' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Histogram2dContour</span><span class='op'>=</span><span class='nam'>Histogram2dContour</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1477' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Scatter</span><span class='op'>=</span><span class='nam'>Scatter</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1478' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>AngularAxis</span><span class='op'>=</span><span class='nam'>AngularAxis</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1479' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Annotation</span><span class='op'>=</span><span class='nam'>Annotation</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1480' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>ColorBar</span><span class='op'>=</span><span class='nam'>ColorBar</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1481' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Contours</span><span class='op'>=</span><span class='nam'>Contours</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1482' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>ErrorX</span><span class='op'>=</span><span class='nam'>ErrorX</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1483' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>ErrorY</span><span class='op'>=</span><span class='nam'>ErrorY</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1484' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Figure</span><span class='op'>=</span><span class='nam'>Figure</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1485' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Font</span><span class='op'>=</span><span class='nam'>Font</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1486' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Layout</span><span class='op'>=</span><span class='nam'>Layout</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1487' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Legend</span><span class='op'>=</span><span class='nam'>Legend</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1488' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Line</span><span class='op'>=</span><span class='nam'>Line</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1489' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Margin</span><span class='op'>=</span><span class='nam'>Margin</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1490' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Marker</span><span class='op'>=</span><span class='nam'>Marker</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1491' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>RadialAxis</span><span class='op'>=</span><span class='nam'>RadialAxis</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1492' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Stream</span><span class='op'>=</span><span class='nam'>Stream</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1493' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>Trace</span><span class='op'>=</span><span class='nam'>Trace</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1494' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>XAxis</span><span class='op'>=</span><span class='nam'>XAxis</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1495' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>XBins</span><span class='op'>=</span><span class='nam'>XBins</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1496' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>YAxis</span><span class='op'>=</span><span class='nam'>YAxis</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t1497' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>YBins</span><span class='op'>=</span><span class='nam'>YBins</span><span class='strut'>&nbsp;</span></p>
-<p id='t1498' class='pln'><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1461' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1462' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1463' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1464' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1465' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>YAxis</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1466' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing a yaxis in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1467' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1468' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1469' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1470' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1471' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1472' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>YBins</span><span class='op'>(</span><span class='nam'>PlotlyDict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t1473' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A dictionary-like object representing bin information for a histogram.</span><span class='strut'>&nbsp;</span></p>
+<p id='t1474' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1475' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1476' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t1477' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t1478' class='pln'><span class='com'># finally... define how to map from a class name to an actual class</span><span class='strut'>&nbsp;</span></p>
+<p id='t1479' class='pln'><span class='com'># mapping: (n-&gt;n)</span><span class='strut'>&nbsp;</span></p>
+<p id='t1480' class='stm run hide_run'><span class='nam'>NAME_TO_CLASS</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t1481' class='pln'>&nbsp; &nbsp; <span class='nam'>PlotlyList</span><span class='op'>=</span><span class='nam'>PlotlyList</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1482' class='pln'>&nbsp; &nbsp; <span class='nam'>Data</span><span class='op'>=</span><span class='nam'>Data</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1483' class='pln'>&nbsp; &nbsp; <span class='nam'>Annotations</span><span class='op'>=</span><span class='nam'>Annotations</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1484' class='pln'>&nbsp; &nbsp; <span class='nam'>PlotlyDict</span><span class='op'>=</span><span class='nam'>PlotlyDict</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1485' class='pln'>&nbsp; &nbsp; <span class='nam'>PlotlyTrace</span><span class='op'>=</span><span class='nam'>PlotlyTrace</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1486' class='pln'>&nbsp; &nbsp; <span class='nam'>Area</span><span class='op'>=</span><span class='nam'>Area</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1487' class='pln'>&nbsp; &nbsp; <span class='nam'>Bar</span><span class='op'>=</span><span class='nam'>Bar</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1488' class='pln'>&nbsp; &nbsp; <span class='nam'>Box</span><span class='op'>=</span><span class='nam'>Box</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1489' class='pln'>&nbsp; &nbsp; <span class='nam'>Contour</span><span class='op'>=</span><span class='nam'>Contour</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1490' class='pln'>&nbsp; &nbsp; <span class='nam'>Heatmap</span><span class='op'>=</span><span class='nam'>Heatmap</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1491' class='pln'>&nbsp; &nbsp; <span class='nam'>Histogram</span><span class='op'>=</span><span class='nam'>Histogram</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1492' class='pln'>&nbsp; &nbsp; <span class='nam'>Histogram2d</span><span class='op'>=</span><span class='nam'>Histogram2d</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1493' class='pln'>&nbsp; &nbsp; <span class='nam'>Histogram2dContour</span><span class='op'>=</span><span class='nam'>Histogram2dContour</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1494' class='pln'>&nbsp; &nbsp; <span class='nam'>Scatter</span><span class='op'>=</span><span class='nam'>Scatter</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1495' class='pln'>&nbsp; &nbsp; <span class='nam'>AngularAxis</span><span class='op'>=</span><span class='nam'>AngularAxis</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1496' class='pln'>&nbsp; &nbsp; <span class='nam'>Annotation</span><span class='op'>=</span><span class='nam'>Annotation</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1497' class='pln'>&nbsp; &nbsp; <span class='nam'>ColorBar</span><span class='op'>=</span><span class='nam'>ColorBar</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1498' class='pln'>&nbsp; &nbsp; <span class='nam'>Contours</span><span class='op'>=</span><span class='nam'>Contours</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1499' class='pln'>&nbsp; &nbsp; <span class='nam'>ErrorX</span><span class='op'>=</span><span class='nam'>ErrorX</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1500' class='pln'>&nbsp; &nbsp; <span class='nam'>ErrorY</span><span class='op'>=</span><span class='nam'>ErrorY</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1501' class='pln'>&nbsp; &nbsp; <span class='nam'>Figure</span><span class='op'>=</span><span class='nam'>Figure</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1502' class='pln'>&nbsp; &nbsp; <span class='nam'>Font</span><span class='op'>=</span><span class='nam'>Font</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1503' class='pln'>&nbsp; &nbsp; <span class='nam'>Layout</span><span class='op'>=</span><span class='nam'>Layout</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1504' class='pln'>&nbsp; &nbsp; <span class='nam'>Legend</span><span class='op'>=</span><span class='nam'>Legend</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1505' class='pln'>&nbsp; &nbsp; <span class='nam'>Line</span><span class='op'>=</span><span class='nam'>Line</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1506' class='pln'>&nbsp; &nbsp; <span class='nam'>Margin</span><span class='op'>=</span><span class='nam'>Margin</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1507' class='pln'>&nbsp; &nbsp; <span class='nam'>Marker</span><span class='op'>=</span><span class='nam'>Marker</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1508' class='pln'>&nbsp; &nbsp; <span class='nam'>RadialAxis</span><span class='op'>=</span><span class='nam'>RadialAxis</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1509' class='pln'>&nbsp; &nbsp; <span class='nam'>Stream</span><span class='op'>=</span><span class='nam'>Stream</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1510' class='pln'>&nbsp; &nbsp; <span class='nam'>Trace</span><span class='op'>=</span><span class='nam'>Trace</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1511' class='pln'>&nbsp; &nbsp; <span class='nam'>XAxis</span><span class='op'>=</span><span class='nam'>XAxis</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1512' class='pln'>&nbsp; &nbsp; <span class='nam'>XBins</span><span class='op'>=</span><span class='nam'>XBins</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1513' class='pln'>&nbsp; &nbsp; <span class='nam'>YAxis</span><span class='op'>=</span><span class='nam'>YAxis</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t1514' class='pln'>&nbsp; &nbsp; <span class='nam'>YBins</span><span class='op'>=</span><span class='nam'>YBins</span><span class='strut'>&nbsp;</span></p>
+<p id='t1515' class='pln'><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
                 
             </td>
         </tr>
diff --git a/plotly/tests/coverage/plotly_matplotlylib_renderer.html b/plotly/tests/coverage/plotly_matplotlylib_renderer.html
--- a/plotly/tests/coverage/plotly_matplotlylib_renderer.html
+++ b/plotly/tests/coverage/plotly_matplotlylib_renderer.html
@@ -25,8 +25,8 @@ <h1>Coverage for <b>plotly/matplotlylib/renderer</b> :
         </h1>
         <img id='keyboard_icon' src='keybd_closed.png'>
         <h2 class='stats'>
-            216 statements &nbsp;
-            <span class='run hide_run shortkey_r button_toggle_run'>157 run</span>
+            217 statements &nbsp;
+            <span class='run hide_run shortkey_r button_toggle_run'>158 run</span>
             <span class='mis shortkey_m button_toggle_mis'>59 missing</span>
             <span class='exc shortkey_x button_toggle_exc'>0 excluded</span>
             
@@ -72,19 +72,19 @@ <h2 class='stats'>
 <p id='n9' class='stm run hide_run'><a href='#n9'>9</a></p>
 <p id='n10' class='pln'><a href='#n10'>10</a></p>
 <p id='n11' class='stm run hide_run'><a href='#n11'>11</a></p>
-<p id='n12' class='stm run hide_run'><a href='#n12'>12</a></p>
+<p id='n12' class='pln'><a href='#n12'>12</a></p>
 <p id='n13' class='stm run hide_run'><a href='#n13'>13</a></p>
-<p id='n14' class='pln'><a href='#n14'>14</a></p>
-<p id='n15' class='pln'><a href='#n15'>15</a></p>
+<p id='n14' class='stm run hide_run'><a href='#n14'>14</a></p>
+<p id='n15' class='stm run hide_run'><a href='#n15'>15</a></p>
 <p id='n16' class='pln'><a href='#n16'>16</a></p>
 <p id='n17' class='pln'><a href='#n17'>17</a></p>
-<p id='n18' class='stm run hide_run'><a href='#n18'>18</a></p>
-<p id='n19' class='stm mis'><a href='#n19'>19</a></p>
+<p id='n18' class='pln'><a href='#n18'>18</a></p>
+<p id='n19' class='pln'><a href='#n19'>19</a></p>
 <p id='n20' class='stm run hide_run'><a href='#n20'>20</a></p>
-<p id='n21' class='pln'><a href='#n21'>21</a></p>
+<p id='n21' class='stm mis'><a href='#n21'>21</a></p>
 <p id='n22' class='stm run hide_run'><a href='#n22'>22</a></p>
 <p id='n23' class='pln'><a href='#n23'>23</a></p>
-<p id='n24' class='pln'><a href='#n24'>24</a></p>
+<p id='n24' class='stm run hide_run'><a href='#n24'>24</a></p>
 <p id='n25' class='pln'><a href='#n25'>25</a></p>
 <p id='n26' class='pln'><a href='#n26'>26</a></p>
 <p id='n27' class='pln'><a href='#n27'>27</a></p>
@@ -100,26 +100,26 @@ <h2 class='stats'>
 <p id='n37' class='pln'><a href='#n37'>37</a></p>
 <p id='n38' class='pln'><a href='#n38'>38</a></p>
 <p id='n39' class='pln'><a href='#n39'>39</a></p>
-<p id='n40' class='stm run hide_run'><a href='#n40'>40</a></p>
+<p id='n40' class='pln'><a href='#n40'>40</a></p>
 <p id='n41' class='pln'><a href='#n41'>41</a></p>
-<p id='n42' class='pln'><a href='#n42'>42</a></p>
+<p id='n42' class='stm run hide_run'><a href='#n42'>42</a></p>
 <p id='n43' class='pln'><a href='#n43'>43</a></p>
 <p id='n44' class='pln'><a href='#n44'>44</a></p>
 <p id='n45' class='pln'><a href='#n45'>45</a></p>
 <p id='n46' class='pln'><a href='#n46'>46</a></p>
 <p id='n47' class='pln'><a href='#n47'>47</a></p>
 <p id='n48' class='pln'><a href='#n48'>48</a></p>
-<p id='n49' class='stm run hide_run'><a href='#n49'>49</a></p>
-<p id='n50' class='stm run hide_run'><a href='#n50'>50</a></p>
+<p id='n49' class='pln'><a href='#n49'>49</a></p>
+<p id='n50' class='pln'><a href='#n50'>50</a></p>
 <p id='n51' class='stm run hide_run'><a href='#n51'>51</a></p>
 <p id='n52' class='stm run hide_run'><a href='#n52'>52</a></p>
 <p id='n53' class='stm run hide_run'><a href='#n53'>53</a></p>
 <p id='n54' class='stm run hide_run'><a href='#n54'>54</a></p>
 <p id='n55' class='stm run hide_run'><a href='#n55'>55</a></p>
-<p id='n56' class='pln'><a href='#n56'>56</a></p>
+<p id='n56' class='stm run hide_run'><a href='#n56'>56</a></p>
 <p id='n57' class='stm run hide_run'><a href='#n57'>57</a></p>
 <p id='n58' class='pln'><a href='#n58'>58</a></p>
-<p id='n59' class='pln'><a href='#n59'>59</a></p>
+<p id='n59' class='stm run hide_run'><a href='#n59'>59</a></p>
 <p id='n60' class='pln'><a href='#n60'>60</a></p>
 <p id='n61' class='pln'><a href='#n61'>61</a></p>
 <p id='n62' class='pln'><a href='#n62'>62</a></p>
@@ -133,25 +133,25 @@ <h2 class='stats'>
 <p id='n70' class='pln'><a href='#n70'>70</a></p>
 <p id='n71' class='pln'><a href='#n71'>71</a></p>
 <p id='n72' class='pln'><a href='#n72'>72</a></p>
-<p id='n73' class='stm run hide_run'><a href='#n73'>73</a></p>
-<p id='n74' class='stm run hide_run'><a href='#n74'>74</a></p>
+<p id='n73' class='pln'><a href='#n73'>73</a></p>
+<p id='n74' class='pln'><a href='#n74'>74</a></p>
 <p id='n75' class='stm run hide_run'><a href='#n75'>75</a></p>
-<p id='n76' class='pln'><a href='#n76'>76</a></p>
-<p id='n77' class='pln'><a href='#n77'>77</a></p>
+<p id='n76' class='stm run hide_run'><a href='#n76'>76</a></p>
+<p id='n77' class='stm run hide_run'><a href='#n77'>77</a></p>
 <p id='n78' class='pln'><a href='#n78'>78</a></p>
 <p id='n79' class='pln'><a href='#n79'>79</a></p>
-<p id='n80' class='stm run hide_run'><a href='#n80'>80</a></p>
-<p id='n81' class='stm run hide_run'><a href='#n81'>81</a></p>
-<p id='n82' class='pln'><a href='#n82'>82</a></p>
-<p id='n83' class='pln'><a href='#n83'>83</a></p>
+<p id='n80' class='pln'><a href='#n80'>80</a></p>
+<p id='n81' class='pln'><a href='#n81'>81</a></p>
+<p id='n82' class='stm run hide_run'><a href='#n82'>82</a></p>
+<p id='n83' class='stm run hide_run'><a href='#n83'>83</a></p>
 <p id='n84' class='pln'><a href='#n84'>84</a></p>
 <p id='n85' class='pln'><a href='#n85'>85</a></p>
 <p id='n86' class='pln'><a href='#n86'>86</a></p>
-<p id='n87' class='stm run hide_run'><a href='#n87'>87</a></p>
+<p id='n87' class='pln'><a href='#n87'>87</a></p>
 <p id='n88' class='pln'><a href='#n88'>88</a></p>
 <p id='n89' class='stm run hide_run'><a href='#n89'>89</a></p>
 <p id='n90' class='pln'><a href='#n90'>90</a></p>
-<p id='n91' class='pln'><a href='#n91'>91</a></p>
+<p id='n91' class='stm run hide_run'><a href='#n91'>91</a></p>
 <p id='n92' class='pln'><a href='#n92'>92</a></p>
 <p id='n93' class='pln'><a href='#n93'>93</a></p>
 <p id='n94' class='pln'><a href='#n94'>94</a></p>
@@ -162,13 +162,13 @@ <h2 class='stats'>
 <p id='n99' class='pln'><a href='#n99'>99</a></p>
 <p id='n100' class='pln'><a href='#n100'>100</a></p>
 <p id='n101' class='pln'><a href='#n101'>101</a></p>
-<p id='n102' class='stm run hide_run'><a href='#n102'>102</a></p>
-<p id='n103' class='stm run hide_run'><a href='#n103'>103</a></p>
+<p id='n102' class='pln'><a href='#n102'>102</a></p>
+<p id='n103' class='pln'><a href='#n103'>103</a></p>
 <p id='n104' class='stm run hide_run'><a href='#n104'>104</a></p>
-<p id='n105' class='pln'><a href='#n105'>105</a></p>
+<p id='n105' class='stm run hide_run'><a href='#n105'>105</a></p>
 <p id='n106' class='stm run hide_run'><a href='#n106'>106</a></p>
 <p id='n107' class='pln'><a href='#n107'>107</a></p>
-<p id='n108' class='pln'><a href='#n108'>108</a></p>
+<p id='n108' class='stm run hide_run'><a href='#n108'>108</a></p>
 <p id='n109' class='pln'><a href='#n109'>109</a></p>
 <p id='n110' class='pln'><a href='#n110'>110</a></p>
 <p id='n111' class='pln'><a href='#n111'>111</a></p>
@@ -197,24 +197,24 @@ <h2 class='stats'>
 <p id='n134' class='pln'><a href='#n134'>134</a></p>
 <p id='n135' class='pln'><a href='#n135'>135</a></p>
 <p id='n136' class='pln'><a href='#n136'>136</a></p>
-<p id='n137' class='stm run hide_run'><a href='#n137'>137</a></p>
-<p id='n138' class='stm run hide_run'><a href='#n138'>138</a></p>
-<p id='n139' class='pln'><a href='#n139'>139</a></p>
+<p id='n137' class='pln'><a href='#n137'>137</a></p>
+<p id='n138' class='pln'><a href='#n138'>138</a></p>
+<p id='n139' class='stm run hide_run'><a href='#n139'>139</a></p>
 <p id='n140' class='stm run hide_run'><a href='#n140'>140</a></p>
 <p id='n141' class='pln'><a href='#n141'>141</a></p>
-<p id='n142' class='pln'><a href='#n142'>142</a></p>
+<p id='n142' class='stm run hide_run'><a href='#n142'>142</a></p>
 <p id='n143' class='pln'><a href='#n143'>143</a></p>
-<p id='n144' class='stm run hide_run'><a href='#n144'>144</a></p>
+<p id='n144' class='pln'><a href='#n144'>144</a></p>
 <p id='n145' class='pln'><a href='#n145'>145</a></p>
-<p id='n146' class='pln'><a href='#n146'>146</a></p>
+<p id='n146' class='stm run hide_run'><a href='#n146'>146</a></p>
 <p id='n147' class='pln'><a href='#n147'>147</a></p>
 <p id='n148' class='pln'><a href='#n148'>148</a></p>
-<p id='n149' class='stm run hide_run'><a href='#n149'>149</a></p>
+<p id='n149' class='pln'><a href='#n149'>149</a></p>
 <p id='n150' class='pln'><a href='#n150'>150</a></p>
-<p id='n151' class='pln'><a href='#n151'>151</a></p>
+<p id='n151' class='stm run hide_run'><a href='#n151'>151</a></p>
 <p id='n152' class='pln'><a href='#n152'>152</a></p>
-<p id='n153' class='stm run hide_run'><a href='#n153'>153</a></p>
-<p id='n154' class='stm run hide_run'><a href='#n154'>154</a></p>
+<p id='n153' class='pln'><a href='#n153'>153</a></p>
+<p id='n154' class='pln'><a href='#n154'>154</a></p>
 <p id='n155' class='stm run hide_run'><a href='#n155'>155</a></p>
 <p id='n156' class='stm run hide_run'><a href='#n156'>156</a></p>
 <p id='n157' class='stm run hide_run'><a href='#n157'>157</a></p>
@@ -223,15 +223,15 @@ <h2 class='stats'>
 <p id='n160' class='stm run hide_run'><a href='#n160'>160</a></p>
 <p id='n161' class='stm run hide_run'><a href='#n161'>161</a></p>
 <p id='n162' class='stm run hide_run'><a href='#n162'>162</a></p>
-<p id='n163' class='pln'><a href='#n163'>163</a></p>
-<p id='n164' class='pln'><a href='#n164'>164</a></p>
+<p id='n163' class='stm run hide_run'><a href='#n163'>163</a></p>
+<p id='n164' class='stm run hide_run'><a href='#n164'>164</a></p>
 <p id='n165' class='pln'><a href='#n165'>165</a></p>
-<p id='n166' class='stm run hide_run'><a href='#n166'>166</a></p>
-<p id='n167' class='stm run hide_run'><a href='#n167'>167</a></p>
-<p id='n168' class='pln'><a href='#n168'>168</a></p>
+<p id='n166' class='pln'><a href='#n166'>166</a></p>
+<p id='n167' class='pln'><a href='#n167'>167</a></p>
+<p id='n168' class='stm run hide_run'><a href='#n168'>168</a></p>
 <p id='n169' class='stm run hide_run'><a href='#n169'>169</a></p>
 <p id='n170' class='pln'><a href='#n170'>170</a></p>
-<p id='n171' class='pln'><a href='#n171'>171</a></p>
+<p id='n171' class='stm run hide_run'><a href='#n171'>171</a></p>
 <p id='n172' class='pln'><a href='#n172'>172</a></p>
 <p id='n173' class='pln'><a href='#n173'>173</a></p>
 <p id='n174' class='pln'><a href='#n174'>174</a></p>
@@ -242,14 +242,14 @@ <h2 class='stats'>
 <p id='n179' class='pln'><a href='#n179'>179</a></p>
 <p id='n180' class='pln'><a href='#n180'>180</a></p>
 <p id='n181' class='pln'><a href='#n181'>181</a></p>
-<p id='n182' class='stm run hide_run'><a href='#n182'>182</a></p>
-<p id='n183' class='stm run hide_run'><a href='#n183'>183</a></p>
+<p id='n182' class='pln'><a href='#n182'>182</a></p>
+<p id='n183' class='pln'><a href='#n183'>183</a></p>
 <p id='n184' class='stm run hide_run'><a href='#n184'>184</a></p>
 <p id='n185' class='stm run hide_run'><a href='#n185'>185</a></p>
-<p id='n186' class='pln'><a href='#n186'>186</a></p>
+<p id='n186' class='stm run hide_run'><a href='#n186'>186</a></p>
 <p id='n187' class='stm run hide_run'><a href='#n187'>187</a></p>
 <p id='n188' class='pln'><a href='#n188'>188</a></p>
-<p id='n189' class='pln'><a href='#n189'>189</a></p>
+<p id='n189' class='stm run hide_run'><a href='#n189'>189</a></p>
 <p id='n190' class='pln'><a href='#n190'>190</a></p>
 <p id='n191' class='pln'><a href='#n191'>191</a></p>
 <p id='n192' class='pln'><a href='#n192'>192</a></p>
@@ -259,43 +259,43 @@ <h2 class='stats'>
 <p id='n196' class='pln'><a href='#n196'>196</a></p>
 <p id='n197' class='pln'><a href='#n197'>197</a></p>
 <p id='n198' class='pln'><a href='#n198'>198</a></p>
-<p id='n199' class='stm run hide_run'><a href='#n199'>199</a></p>
-<p id='n200' class='stm run hide_run'><a href='#n200'>200</a></p>
+<p id='n199' class='pln'><a href='#n199'>199</a></p>
+<p id='n200' class='pln'><a href='#n200'>200</a></p>
 <p id='n201' class='stm run hide_run'><a href='#n201'>201</a></p>
 <p id='n202' class='stm run hide_run'><a href='#n202'>202</a></p>
 <p id='n203' class='stm run hide_run'><a href='#n203'>203</a></p>
 <p id='n204' class='stm run hide_run'><a href='#n204'>204</a></p>
 <p id='n205' class='stm run hide_run'><a href='#n205'>205</a></p>
-<p id='n206' class='pln'><a href='#n206'>206</a></p>
-<p id='n207' class='pln'><a href='#n207'>207</a></p>
-<p id='n208' class='stm run hide_run'><a href='#n208'>208</a></p>
-<p id='n209' class='stm run hide_run'><a href='#n209'>209</a></p>
+<p id='n206' class='stm run hide_run'><a href='#n206'>206</a></p>
+<p id='n207' class='stm run hide_run'><a href='#n207'>207</a></p>
+<p id='n208' class='pln'><a href='#n208'>208</a></p>
+<p id='n209' class='pln'><a href='#n209'>209</a></p>
 <p id='n210' class='stm run hide_run'><a href='#n210'>210</a></p>
 <p id='n211' class='stm run hide_run'><a href='#n211'>211</a></p>
 <p id='n212' class='stm run hide_run'><a href='#n212'>212</a></p>
-<p id='n213' class='pln'><a href='#n213'>213</a></p>
+<p id='n213' class='stm run hide_run'><a href='#n213'>213</a></p>
 <p id='n214' class='stm run hide_run'><a href='#n214'>214</a></p>
 <p id='n215' class='pln'><a href='#n215'>215</a></p>
-<p id='n216' class='pln'><a href='#n216'>216</a></p>
+<p id='n216' class='stm run hide_run'><a href='#n216'>216</a></p>
 <p id='n217' class='pln'><a href='#n217'>217</a></p>
 <p id='n218' class='pln'><a href='#n218'>218</a></p>
 <p id='n219' class='pln'><a href='#n219'>219</a></p>
 <p id='n220' class='pln'><a href='#n220'>220</a></p>
 <p id='n221' class='pln'><a href='#n221'>221</a></p>
 <p id='n222' class='pln'><a href='#n222'>222</a></p>
-<p id='n223' class='stm run hide_run'><a href='#n223'>223</a></p>
-<p id='n224' class='stm run hide_run'><a href='#n224'>224</a></p>
+<p id='n223' class='pln'><a href='#n223'>223</a></p>
+<p id='n224' class='pln'><a href='#n224'>224</a></p>
 <p id='n225' class='stm run hide_run'><a href='#n225'>225</a></p>
 <p id='n226' class='stm run hide_run'><a href='#n226'>226</a></p>
 <p id='n227' class='stm run hide_run'><a href='#n227'>227</a></p>
-<p id='n228' class='pln'><a href='#n228'>228</a></p>
+<p id='n228' class='stm run hide_run'><a href='#n228'>228</a></p>
 <p id='n229' class='stm run hide_run'><a href='#n229'>229</a></p>
-<p id='n230' class='stm run hide_run'><a href='#n230'>230</a></p>
-<p id='n231' class='pln'><a href='#n231'>231</a></p>
-<p id='n232' class='pln'><a href='#n232'>232</a></p>
-<p id='n233' class='stm run hide_run'><a href='#n233'>233</a></p>
+<p id='n230' class='pln'><a href='#n230'>230</a></p>
+<p id='n231' class='stm run hide_run'><a href='#n231'>231</a></p>
+<p id='n232' class='stm run hide_run'><a href='#n232'>232</a></p>
+<p id='n233' class='pln'><a href='#n233'>233</a></p>
 <p id='n234' class='pln'><a href='#n234'>234</a></p>
-<p id='n235' class='pln'><a href='#n235'>235</a></p>
+<p id='n235' class='stm run hide_run'><a href='#n235'>235</a></p>
 <p id='n236' class='pln'><a href='#n236'>236</a></p>
 <p id='n237' class='pln'><a href='#n237'>237</a></p>
 <p id='n238' class='pln'><a href='#n238'>238</a></p>
@@ -326,28 +326,28 @@ <h2 class='stats'>
 <p id='n263' class='pln'><a href='#n263'>263</a></p>
 <p id='n264' class='pln'><a href='#n264'>264</a></p>
 <p id='n265' class='pln'><a href='#n265'>265</a></p>
-<p id='n266' class='stm run hide_run'><a href='#n266'>266</a></p>
-<p id='n267' class='stm run hide_run'><a href='#n267'>267</a></p>
+<p id='n266' class='pln'><a href='#n266'>266</a></p>
+<p id='n267' class='pln'><a href='#n267'>267</a></p>
 <p id='n268' class='stm run hide_run'><a href='#n268'>268</a></p>
-<p id='n269' class='stm mis'><a href='#n269'>269</a></p>
-<p id='n270' class='stm mis'><a href='#n270'>270</a></p>
-<p id='n271' class='stm run hide_run'><a href='#n271'>271</a></p>
-<p id='n272' class='stm run hide_run'><a href='#n272'>272</a></p>
+<p id='n269' class='stm run hide_run'><a href='#n269'>269</a></p>
+<p id='n270' class='stm run hide_run'><a href='#n270'>270</a></p>
+<p id='n271' class='stm mis'><a href='#n271'>271</a></p>
+<p id='n272' class='stm mis'><a href='#n272'>272</a></p>
 <p id='n273' class='stm run hide_run'><a href='#n273'>273</a></p>
 <p id='n274' class='stm run hide_run'><a href='#n274'>274</a></p>
 <p id='n275' class='stm run hide_run'><a href='#n275'>275</a></p>
 <p id='n276' class='stm run hide_run'><a href='#n276'>276</a></p>
 <p id='n277' class='stm run hide_run'><a href='#n277'>277</a></p>
 <p id='n278' class='stm run hide_run'><a href='#n278'>278</a></p>
-<p id='n279' class='pln'><a href='#n279'>279</a></p>
-<p id='n280' class='pln'><a href='#n280'>280</a></p>
+<p id='n279' class='stm run hide_run'><a href='#n279'>279</a></p>
+<p id='n280' class='stm run hide_run'><a href='#n280'>280</a></p>
 <p id='n281' class='pln'><a href='#n281'>281</a></p>
 <p id='n282' class='pln'><a href='#n282'>282</a></p>
 <p id='n283' class='pln'><a href='#n283'>283</a></p>
-<p id='n284' class='stm run hide_run'><a href='#n284'>284</a></p>
-<p id='n285' class='stm run hide_run'><a href='#n285'>285</a></p>
-<p id='n286' class='pln'><a href='#n286'>286</a></p>
-<p id='n287' class='pln'><a href='#n287'>287</a></p>
+<p id='n284' class='pln'><a href='#n284'>284</a></p>
+<p id='n285' class='pln'><a href='#n285'>285</a></p>
+<p id='n286' class='stm run hide_run'><a href='#n286'>286</a></p>
+<p id='n287' class='stm run hide_run'><a href='#n287'>287</a></p>
 <p id='n288' class='pln'><a href='#n288'>288</a></p>
 <p id='n289' class='pln'><a href='#n289'>289</a></p>
 <p id='n290' class='pln'><a href='#n290'>290</a></p>
@@ -355,39 +355,39 @@ <h2 class='stats'>
 <p id='n292' class='pln'><a href='#n292'>292</a></p>
 <p id='n293' class='pln'><a href='#n293'>293</a></p>
 <p id='n294' class='pln'><a href='#n294'>294</a></p>
-<p id='n295' class='stm run hide_run'><a href='#n295'>295</a></p>
-<p id='n296' class='stm run hide_run'><a href='#n296'>296</a></p>
-<p id='n297' class='pln'><a href='#n297'>297</a></p>
-<p id='n298' class='pln'><a href='#n298'>298</a></p>
+<p id='n295' class='pln'><a href='#n295'>295</a></p>
+<p id='n296' class='pln'><a href='#n296'>296</a></p>
+<p id='n297' class='stm run hide_run'><a href='#n297'>297</a></p>
+<p id='n298' class='stm run hide_run'><a href='#n298'>298</a></p>
 <p id='n299' class='pln'><a href='#n299'>299</a></p>
 <p id='n300' class='pln'><a href='#n300'>300</a></p>
 <p id='n301' class='pln'><a href='#n301'>301</a></p>
 <p id='n302' class='pln'><a href='#n302'>302</a></p>
 <p id='n303' class='pln'><a href='#n303'>303</a></p>
-<p id='n304' class='stm run hide_run'><a href='#n304'>304</a></p>
-<p id='n305' class='stm run hide_run'><a href='#n305'>305</a></p>
-<p id='n306' class='pln'><a href='#n306'>306</a></p>
-<p id='n307' class='stm mis'><a href='#n307'>307</a></p>
+<p id='n304' class='pln'><a href='#n304'>304</a></p>
+<p id='n305' class='pln'><a href='#n305'>305</a></p>
+<p id='n306' class='stm run hide_run'><a href='#n306'>306</a></p>
+<p id='n307' class='stm run hide_run'><a href='#n307'>307</a></p>
 <p id='n308' class='pln'><a href='#n308'>308</a></p>
 <p id='n309' class='stm mis'><a href='#n309'>309</a></p>
 <p id='n310' class='pln'><a href='#n310'>310</a></p>
-<p id='n311' class='pln'><a href='#n311'>311</a></p>
+<p id='n311' class='stm mis'><a href='#n311'>311</a></p>
 <p id='n312' class='pln'><a href='#n312'>312</a></p>
-<p id='n313' class='stm run hide_run'><a href='#n313'>313</a></p>
+<p id='n313' class='pln'><a href='#n313'>313</a></p>
 <p id='n314' class='pln'><a href='#n314'>314</a></p>
-<p id='n315' class='pln'><a href='#n315'>315</a></p>
+<p id='n315' class='stm run hide_run'><a href='#n315'>315</a></p>
 <p id='n316' class='pln'><a href='#n316'>316</a></p>
 <p id='n317' class='pln'><a href='#n317'>317</a></p>
 <p id='n318' class='pln'><a href='#n318'>318</a></p>
-<p id='n319' class='stm mis'><a href='#n319'>319</a></p>
-<p id='n320' class='stm mis'><a href='#n320'>320</a></p>
+<p id='n319' class='pln'><a href='#n319'>319</a></p>
+<p id='n320' class='pln'><a href='#n320'>320</a></p>
 <p id='n321' class='stm mis'><a href='#n321'>321</a></p>
-<p id='n322' class='pln'><a href='#n322'>322</a></p>
-<p id='n323' class='pln'><a href='#n323'>323</a></p>
+<p id='n322' class='stm mis'><a href='#n322'>322</a></p>
+<p id='n323' class='stm mis'><a href='#n323'>323</a></p>
 <p id='n324' class='pln'><a href='#n324'>324</a></p>
-<p id='n325' class='stm run hide_run'><a href='#n325'>325</a></p>
+<p id='n325' class='pln'><a href='#n325'>325</a></p>
 <p id='n326' class='pln'><a href='#n326'>326</a></p>
-<p id='n327' class='pln'><a href='#n327'>327</a></p>
+<p id='n327' class='stm run hide_run'><a href='#n327'>327</a></p>
 <p id='n328' class='pln'><a href='#n328'>328</a></p>
 <p id='n329' class='pln'><a href='#n329'>329</a></p>
 <p id='n330' class='pln'><a href='#n330'>330</a></p>
@@ -415,29 +415,29 @@ <h2 class='stats'>
 <p id='n352' class='pln'><a href='#n352'>352</a></p>
 <p id='n353' class='pln'><a href='#n353'>353</a></p>
 <p id='n354' class='pln'><a href='#n354'>354</a></p>
-<p id='n355' class='stm run hide_run'><a href='#n355'>355</a></p>
-<p id='n356' class='stm run hide_run'><a href='#n356'>356</a></p>
+<p id='n355' class='pln'><a href='#n355'>355</a></p>
+<p id='n356' class='pln'><a href='#n356'>356</a></p>
 <p id='n357' class='stm run hide_run'><a href='#n357'>357</a></p>
 <p id='n358' class='stm run hide_run'><a href='#n358'>358</a></p>
-<p id='n359' class='pln'><a href='#n359'>359</a></p>
-<p id='n360' class='pln'><a href='#n360'>360</a></p>
+<p id='n359' class='stm run hide_run'><a href='#n359'>359</a></p>
+<p id='n360' class='stm run hide_run'><a href='#n360'>360</a></p>
 <p id='n361' class='pln'><a href='#n361'>361</a></p>
 <p id='n362' class='pln'><a href='#n362'>362</a></p>
 <p id='n363' class='pln'><a href='#n363'>363</a></p>
 <p id='n364' class='pln'><a href='#n364'>364</a></p>
-<p id='n365' class='stm run hide_run'><a href='#n365'>365</a></p>
-<p id='n366' class='stm run hide_run'><a href='#n366'>366</a></p>
-<p id='n367' class='pln'><a href='#n367'>367</a></p>
-<p id='n368' class='stm mis'><a href='#n368'>368</a></p>
+<p id='n365' class='pln'><a href='#n365'>365</a></p>
+<p id='n366' class='pln'><a href='#n366'>366</a></p>
+<p id='n367' class='stm run hide_run'><a href='#n367'>367</a></p>
+<p id='n368' class='stm run hide_run'><a href='#n368'>368</a></p>
 <p id='n369' class='pln'><a href='#n369'>369</a></p>
 <p id='n370' class='stm mis'><a href='#n370'>370</a></p>
 <p id='n371' class='pln'><a href='#n371'>371</a></p>
-<p id='n372' class='pln'><a href='#n372'>372</a></p>
+<p id='n372' class='stm mis'><a href='#n372'>372</a></p>
 <p id='n373' class='pln'><a href='#n373'>373</a></p>
 <p id='n374' class='pln'><a href='#n374'>374</a></p>
-<p id='n375' class='stm run hide_run'><a href='#n375'>375</a></p>
+<p id='n375' class='pln'><a href='#n375'>375</a></p>
 <p id='n376' class='pln'><a href='#n376'>376</a></p>
-<p id='n377' class='pln'><a href='#n377'>377</a></p>
+<p id='n377' class='stm run hide_run'><a href='#n377'>377</a></p>
 <p id='n378' class='pln'><a href='#n378'>378</a></p>
 <p id='n379' class='pln'><a href='#n379'>379</a></p>
 <p id='n380' class='pln'><a href='#n380'>380</a></p>
@@ -460,8 +460,8 @@ <h2 class='stats'>
 <p id='n397' class='pln'><a href='#n397'>397</a></p>
 <p id='n398' class='pln'><a href='#n398'>398</a></p>
 <p id='n399' class='pln'><a href='#n399'>399</a></p>
-<p id='n400' class='stm run hide_run'><a href='#n400'>400</a></p>
-<p id='n401' class='stm run hide_run'><a href='#n401'>401</a></p>
+<p id='n400' class='pln'><a href='#n400'>400</a></p>
+<p id='n401' class='pln'><a href='#n401'>401</a></p>
 <p id='n402' class='stm run hide_run'><a href='#n402'>402</a></p>
 <p id='n403' class='stm run hide_run'><a href='#n403'>403</a></p>
 <p id='n404' class='stm run hide_run'><a href='#n404'>404</a></p>
@@ -472,13 +472,13 @@ <h2 class='stats'>
 <p id='n409' class='stm run hide_run'><a href='#n409'>409</a></p>
 <p id='n410' class='stm run hide_run'><a href='#n410'>410</a></p>
 <p id='n411' class='stm run hide_run'><a href='#n411'>411</a></p>
-<p id='n412' class='stm mis'><a href='#n412'>412</a></p>
-<p id='n413' class='stm mis'><a href='#n413'>413</a></p>
-<p id='n414' class='pln'><a href='#n414'>414</a></p>
-<p id='n415' class='pln'><a href='#n415'>415</a></p>
-<p id='n416' class='stm run hide_run'><a href='#n416'>416</a></p>
+<p id='n412' class='stm run hide_run'><a href='#n412'>412</a></p>
+<p id='n413' class='stm run hide_run'><a href='#n413'>413</a></p>
+<p id='n414' class='stm mis'><a href='#n414'>414</a></p>
+<p id='n415' class='stm mis'><a href='#n415'>415</a></p>
+<p id='n416' class='pln'><a href='#n416'>416</a></p>
 <p id='n417' class='pln'><a href='#n417'>417</a></p>
-<p id='n418' class='pln'><a href='#n418'>418</a></p>
+<p id='n418' class='stm run hide_run'><a href='#n418'>418</a></p>
 <p id='n419' class='pln'><a href='#n419'>419</a></p>
 <p id='n420' class='pln'><a href='#n420'>420</a></p>
 <p id='n421' class='pln'><a href='#n421'>421</a></p>
@@ -501,29 +501,29 @@ <h2 class='stats'>
 <p id='n438' class='pln'><a href='#n438'>438</a></p>
 <p id='n439' class='pln'><a href='#n439'>439</a></p>
 <p id='n440' class='pln'><a href='#n440'>440</a></p>
-<p id='n441' class='stm run hide_run'><a href='#n441'>441</a></p>
-<p id='n442' class='stm run hide_run'><a href='#n442'>442</a></p>
+<p id='n441' class='pln'><a href='#n441'>441</a></p>
+<p id='n442' class='pln'><a href='#n442'>442</a></p>
 <p id='n443' class='stm run hide_run'><a href='#n443'>443</a></p>
-<p id='n444' class='pln'><a href='#n444'>444</a></p>
+<p id='n444' class='stm run hide_run'><a href='#n444'>444</a></p>
 <p id='n445' class='stm run hide_run'><a href='#n445'>445</a></p>
-<p id='n446' class='stm run hide_run'><a href='#n446'>446</a></p>
-<p id='n447' class='pln'><a href='#n447'>447</a></p>
+<p id='n446' class='pln'><a href='#n446'>446</a></p>
+<p id='n447' class='stm run hide_run'><a href='#n447'>447</a></p>
 <p id='n448' class='stm run hide_run'><a href='#n448'>448</a></p>
-<p id='n449' class='stm run hide_run'><a href='#n449'>449</a></p>
+<p id='n449' class='pln'><a href='#n449'>449</a></p>
 <p id='n450' class='stm run hide_run'><a href='#n450'>450</a></p>
 <p id='n451' class='stm run hide_run'><a href='#n451'>451</a></p>
 <p id='n452' class='stm run hide_run'><a href='#n452'>452</a></p>
 <p id='n453' class='stm run hide_run'><a href='#n453'>453</a></p>
-<p id='n454' class='pln'><a href='#n454'>454</a></p>
+<p id='n454' class='stm run hide_run'><a href='#n454'>454</a></p>
 <p id='n455' class='stm run hide_run'><a href='#n455'>455</a></p>
-<p id='n456' class='stm run hide_run'><a href='#n456'>456</a></p>
-<p id='n457' class='pln'><a href='#n457'>457</a></p>
+<p id='n456' class='pln'><a href='#n456'>456</a></p>
+<p id='n457' class='stm run hide_run'><a href='#n457'>457</a></p>
 <p id='n458' class='stm run hide_run'><a href='#n458'>458</a></p>
-<p id='n459' class='stm run hide_run'><a href='#n459'>459</a></p>
-<p id='n460' class='pln'><a href='#n460'>460</a></p>
+<p id='n459' class='pln'><a href='#n459'>459</a></p>
+<p id='n460' class='stm run hide_run'><a href='#n460'>460</a></p>
 <p id='n461' class='stm run hide_run'><a href='#n461'>461</a></p>
 <p id='n462' class='pln'><a href='#n462'>462</a></p>
-<p id='n463' class='pln'><a href='#n463'>463</a></p>
+<p id='n463' class='stm run hide_run'><a href='#n463'>463</a></p>
 <p id='n464' class='pln'><a href='#n464'>464</a></p>
 <p id='n465' class='pln'><a href='#n465'>465</a></p>
 <p id='n466' class='pln'><a href='#n466'>466</a></p>
@@ -550,54 +550,54 @@ <h2 class='stats'>
 <p id='n487' class='pln'><a href='#n487'>487</a></p>
 <p id='n488' class='pln'><a href='#n488'>488</a></p>
 <p id='n489' class='pln'><a href='#n489'>489</a></p>
-<p id='n490' class='stm run hide_run'><a href='#n490'>490</a></p>
-<p id='n491' class='stm run hide_run'><a href='#n491'>491</a></p>
-<p id='n492' class='stm mis'><a href='#n492'>492</a></p>
-<p id='n493' class='pln'><a href='#n493'>493</a></p>
-<p id='n494' class='pln'><a href='#n494'>494</a></p>
+<p id='n490' class='pln'><a href='#n490'>490</a></p>
+<p id='n491' class='pln'><a href='#n491'>491</a></p>
+<p id='n492' class='stm run hide_run'><a href='#n492'>492</a></p>
+<p id='n493' class='stm run hide_run'><a href='#n493'>493</a></p>
+<p id='n494' class='stm mis'><a href='#n494'>494</a></p>
 <p id='n495' class='pln'><a href='#n495'>495</a></p>
 <p id='n496' class='pln'><a href='#n496'>496</a></p>
 <p id='n497' class='pln'><a href='#n497'>497</a></p>
 <p id='n498' class='pln'><a href='#n498'>498</a></p>
-<p id='n499' class='stm run hide_run'><a href='#n499'>499</a></p>
-<p id='n500' class='stm run hide_run'><a href='#n500'>500</a></p>
+<p id='n499' class='pln'><a href='#n499'>499</a></p>
+<p id='n500' class='pln'><a href='#n500'>500</a></p>
 <p id='n501' class='stm run hide_run'><a href='#n501'>501</a></p>
 <p id='n502' class='stm run hide_run'><a href='#n502'>502</a></p>
 <p id='n503' class='stm run hide_run'><a href='#n503'>503</a></p>
 <p id='n504' class='stm run hide_run'><a href='#n504'>504</a></p>
-<p id='n505' class='stm mis'><a href='#n505'>505</a></p>
-<p id='n506' class='stm mis'><a href='#n506'>506</a></p>
-<p id='n507' class='stm run hide_run'><a href='#n507'>507</a></p>
+<p id='n505' class='stm run hide_run'><a href='#n505'>505</a></p>
+<p id='n506' class='stm run hide_run'><a href='#n506'>506</a></p>
+<p id='n507' class='stm mis'><a href='#n507'>507</a></p>
 <p id='n508' class='stm mis'><a href='#n508'>508</a></p>
-<p id='n509' class='stm mis'><a href='#n509'>509</a></p>
-<p id='n510' class='stm run hide_run'><a href='#n510'>510</a></p>
+<p id='n509' class='stm run hide_run'><a href='#n509'>509</a></p>
+<p id='n510' class='stm mis'><a href='#n510'>510</a></p>
 <p id='n511' class='stm mis'><a href='#n511'>511</a></p>
-<p id='n512' class='stm mis'><a href='#n512'>512</a></p>
-<p id='n513' class='pln'><a href='#n513'>513</a></p>
-<p id='n514' class='stm run hide_run'><a href='#n514'>514</a></p>
-<p id='n515' class='stm run hide_run'><a href='#n515'>515</a></p>
+<p id='n512' class='stm run hide_run'><a href='#n512'>512</a></p>
+<p id='n513' class='stm mis'><a href='#n513'>513</a></p>
+<p id='n514' class='stm mis'><a href='#n514'>514</a></p>
+<p id='n515' class='pln'><a href='#n515'>515</a></p>
 <p id='n516' class='stm run hide_run'><a href='#n516'>516</a></p>
-<p id='n517' class='pln'><a href='#n517'>517</a></p>
+<p id='n517' class='stm run hide_run'><a href='#n517'>517</a></p>
 <p id='n518' class='stm run hide_run'><a href='#n518'>518</a></p>
 <p id='n519' class='pln'><a href='#n519'>519</a></p>
 <p id='n520' class='stm run hide_run'><a href='#n520'>520</a></p>
 <p id='n521' class='pln'><a href='#n521'>521</a></p>
 <p id='n522' class='stm run hide_run'><a href='#n522'>522</a></p>
-<p id='n523' class='stm run hide_run'><a href='#n523'>523</a></p>
+<p id='n523' class='pln'><a href='#n523'>523</a></p>
 <p id='n524' class='stm run hide_run'><a href='#n524'>524</a></p>
 <p id='n525' class='stm run hide_run'><a href='#n525'>525</a></p>
-<p id='n526' class='pln'><a href='#n526'>526</a></p>
-<p id='n527' class='stm mis'><a href='#n527'>527</a></p>
+<p id='n526' class='stm run hide_run'><a href='#n526'>526</a></p>
+<p id='n527' class='stm run hide_run'><a href='#n527'>527</a></p>
 <p id='n528' class='pln'><a href='#n528'>528</a></p>
 <p id='n529' class='stm mis'><a href='#n529'>529</a></p>
-<p id='n530' class='stm mis'><a href='#n530'>530</a></p>
+<p id='n530' class='pln'><a href='#n530'>530</a></p>
 <p id='n531' class='stm mis'><a href='#n531'>531</a></p>
 <p id='n532' class='stm mis'><a href='#n532'>532</a></p>
 <p id='n533' class='stm mis'><a href='#n533'>533</a></p>
-<p id='n534' class='pln'><a href='#n534'>534</a></p>
+<p id='n534' class='stm mis'><a href='#n534'>534</a></p>
 <p id='n535' class='stm mis'><a href='#n535'>535</a></p>
-<p id='n536' class='stm mis'><a href='#n536'>536</a></p>
-<p id='n537' class='pln'><a href='#n537'>537</a></p>
+<p id='n536' class='pln'><a href='#n536'>536</a></p>
+<p id='n537' class='stm mis'><a href='#n537'>537</a></p>
 <p id='n538' class='stm mis'><a href='#n538'>538</a></p>
 <p id='n539' class='pln'><a href='#n539'>539</a></p>
 <p id='n540' class='stm mis'><a href='#n540'>540</a></p>
@@ -605,12 +605,12 @@ <h2 class='stats'>
 <p id='n542' class='stm mis'><a href='#n542'>542</a></p>
 <p id='n543' class='pln'><a href='#n543'>543</a></p>
 <p id='n544' class='stm mis'><a href='#n544'>544</a></p>
-<p id='n545' class='stm mis'><a href='#n545'>545</a></p>
+<p id='n545' class='pln'><a href='#n545'>545</a></p>
 <p id='n546' class='stm mis'><a href='#n546'>546</a></p>
 <p id='n547' class='stm mis'><a href='#n547'>547</a></p>
-<p id='n548' class='stm run hide_run'><a href='#n548'>548</a></p>
-<p id='n549' class='pln'><a href='#n549'>549</a></p>
-<p id='n550' class='pln'><a href='#n550'>550</a></p>
+<p id='n548' class='stm mis'><a href='#n548'>548</a></p>
+<p id='n549' class='stm mis'><a href='#n549'>549</a></p>
+<p id='n550' class='stm run hide_run'><a href='#n550'>550</a></p>
 <p id='n551' class='pln'><a href='#n551'>551</a></p>
 <p id='n552' class='pln'><a href='#n552'>552</a></p>
 <p id='n553' class='pln'><a href='#n553'>553</a></p>
@@ -624,12 +624,12 @@ <h2 class='stats'>
 <p id='n561' class='pln'><a href='#n561'>561</a></p>
 <p id='n562' class='pln'><a href='#n562'>562</a></p>
 <p id='n563' class='pln'><a href='#n563'>563</a></p>
-<p id='n564' class='stm run hide_run'><a href='#n564'>564</a></p>
-<p id='n565' class='stm run hide_run'><a href='#n565'>565</a></p>
-<p id='n566' class='pln'><a href='#n566'>566</a></p>
+<p id='n564' class='pln'><a href='#n564'>564</a></p>
+<p id='n565' class='pln'><a href='#n565'>565</a></p>
+<p id='n566' class='stm run hide_run'><a href='#n566'>566</a></p>
 <p id='n567' class='stm run hide_run'><a href='#n567'>567</a></p>
 <p id='n568' class='pln'><a href='#n568'>568</a></p>
-<p id='n569' class='pln'><a href='#n569'>569</a></p>
+<p id='n569' class='stm run hide_run'><a href='#n569'>569</a></p>
 <p id='n570' class='pln'><a href='#n570'>570</a></p>
 <p id='n571' class='pln'><a href='#n571'>571</a></p>
 <p id='n572' class='pln'><a href='#n572'>572</a></p>
@@ -653,17 +653,17 @@ <h2 class='stats'>
 <p id='n590' class='pln'><a href='#n590'>590</a></p>
 <p id='n591' class='pln'><a href='#n591'>591</a></p>
 <p id='n592' class='pln'><a href='#n592'>592</a></p>
-<p id='n593' class='stm mis'><a href='#n593'>593</a></p>
-<p id='n594' class='stm mis'><a href='#n594'>594</a></p>
+<p id='n593' class='pln'><a href='#n593'>593</a></p>
+<p id='n594' class='pln'><a href='#n594'>594</a></p>
 <p id='n595' class='stm mis'><a href='#n595'>595</a></p>
-<p id='n596' class='pln'><a href='#n596'>596</a></p>
+<p id='n596' class='stm mis'><a href='#n596'>596</a></p>
 <p id='n597' class='stm mis'><a href='#n597'>597</a></p>
 <p id='n598' class='pln'><a href='#n598'>598</a></p>
 <p id='n599' class='stm mis'><a href='#n599'>599</a></p>
 <p id='n600' class='pln'><a href='#n600'>600</a></p>
 <p id='n601' class='stm mis'><a href='#n601'>601</a></p>
 <p id='n602' class='pln'><a href='#n602'>602</a></p>
-<p id='n603' class='pln'><a href='#n603'>603</a></p>
+<p id='n603' class='stm mis'><a href='#n603'>603</a></p>
 <p id='n604' class='pln'><a href='#n604'>604</a></p>
 <p id='n605' class='pln'><a href='#n605'>605</a></p>
 <p id='n606' class='pln'><a href='#n606'>606</a></p>
@@ -674,19 +674,19 @@ <h2 class='stats'>
 <p id='n611' class='pln'><a href='#n611'>611</a></p>
 <p id='n612' class='pln'><a href='#n612'>612</a></p>
 <p id='n613' class='pln'><a href='#n613'>613</a></p>
-<p id='n614' class='stm mis'><a href='#n614'>614</a></p>
+<p id='n614' class='pln'><a href='#n614'>614</a></p>
 <p id='n615' class='pln'><a href='#n615'>615</a></p>
 <p id='n616' class='stm mis'><a href='#n616'>616</a></p>
 <p id='n617' class='pln'><a href='#n617'>617</a></p>
 <p id='n618' class='stm mis'><a href='#n618'>618</a></p>
-<p id='n619' class='stm mis'><a href='#n619'>619</a></p>
-<p id='n620' class='pln'><a href='#n620'>620</a></p>
-<p id='n621' class='pln'><a href='#n621'>621</a></p>
-<p id='n622' class='stm mis'><a href='#n622'>622</a></p>
+<p id='n619' class='pln'><a href='#n619'>619</a></p>
+<p id='n620' class='stm mis'><a href='#n620'>620</a></p>
+<p id='n621' class='stm mis'><a href='#n621'>621</a></p>
+<p id='n622' class='pln'><a href='#n622'>622</a></p>
 <p id='n623' class='pln'><a href='#n623'>623</a></p>
-<p id='n624' class='stm run hide_run'><a href='#n624'>624</a></p>
+<p id='n624' class='stm mis'><a href='#n624'>624</a></p>
 <p id='n625' class='pln'><a href='#n625'>625</a></p>
-<p id='n626' class='pln'><a href='#n626'>626</a></p>
+<p id='n626' class='stm run hide_run'><a href='#n626'>626</a></p>
 <p id='n627' class='pln'><a href='#n627'>627</a></p>
 <p id='n628' class='pln'><a href='#n628'>628</a></p>
 <p id='n629' class='pln'><a href='#n629'>629</a></p>
@@ -707,16 +707,16 @@ <h2 class='stats'>
 <p id='n644' class='pln'><a href='#n644'>644</a></p>
 <p id='n645' class='pln'><a href='#n645'>645</a></p>
 <p id='n646' class='pln'><a href='#n646'>646</a></p>
-<p id='n647' class='stm mis'><a href='#n647'>647</a></p>
-<p id='n648' class='stm mis'><a href='#n648'>648</a></p>
+<p id='n647' class='pln'><a href='#n647'>647</a></p>
+<p id='n648' class='pln'><a href='#n648'>648</a></p>
 <p id='n649' class='stm mis'><a href='#n649'>649</a></p>
 <p id='n650' class='stm mis'><a href='#n650'>650</a></p>
-<p id='n651' class='pln'><a href='#n651'>651</a></p>
+<p id='n651' class='stm mis'><a href='#n651'>651</a></p>
 <p id='n652' class='stm mis'><a href='#n652'>652</a></p>
 <p id='n653' class='pln'><a href='#n653'>653</a></p>
-<p id='n654' class='stm run hide_run'><a href='#n654'>654</a></p>
+<p id='n654' class='stm mis'><a href='#n654'>654</a></p>
 <p id='n655' class='pln'><a href='#n655'>655</a></p>
-<p id='n656' class='pln'><a href='#n656'>656</a></p>
+<p id='n656' class='stm run hide_run'><a href='#n656'>656</a></p>
 <p id='n657' class='pln'><a href='#n657'>657</a></p>
 <p id='n658' class='pln'><a href='#n658'>658</a></p>
 <p id='n659' class='pln'><a href='#n659'>659</a></p>
@@ -737,32 +737,34 @@ <h2 class='stats'>
 <p id='n674' class='pln'><a href='#n674'>674</a></p>
 <p id='n675' class='pln'><a href='#n675'>675</a></p>
 <p id='n676' class='pln'><a href='#n676'>676</a></p>
-<p id='n677' class='stm mis'><a href='#n677'>677</a></p>
-<p id='n678' class='stm mis'><a href='#n678'>678</a></p>
+<p id='n677' class='pln'><a href='#n677'>677</a></p>
+<p id='n678' class='pln'><a href='#n678'>678</a></p>
 <p id='n679' class='stm mis'><a href='#n679'>679</a></p>
 <p id='n680' class='stm mis'><a href='#n680'>680</a></p>
-<p id='n681' class='pln'><a href='#n681'>681</a></p>
+<p id='n681' class='stm mis'><a href='#n681'>681</a></p>
 <p id='n682' class='stm mis'><a href='#n682'>682</a></p>
 <p id='n683' class='pln'><a href='#n683'>683</a></p>
-<p id='n684' class='stm run hide_run'><a href='#n684'>684</a></p>
+<p id='n684' class='stm mis'><a href='#n684'>684</a></p>
 <p id='n685' class='pln'><a href='#n685'>685</a></p>
-<p id='n686' class='pln'><a href='#n686'>686</a></p>
+<p id='n686' class='stm run hide_run'><a href='#n686'>686</a></p>
 <p id='n687' class='pln'><a href='#n687'>687</a></p>
 <p id='n688' class='pln'><a href='#n688'>688</a></p>
 <p id='n689' class='pln'><a href='#n689'>689</a></p>
 <p id='n690' class='pln'><a href='#n690'>690</a></p>
 <p id='n691' class='pln'><a href='#n691'>691</a></p>
 <p id='n692' class='pln'><a href='#n692'>692</a></p>
-<p id='n693' class='stm run hide_run'><a href='#n693'>693</a></p>
-<p id='n694' class='stm run hide_run'><a href='#n694'>694</a></p>
+<p id='n693' class='pln'><a href='#n693'>693</a></p>
+<p id='n694' class='pln'><a href='#n694'>694</a></p>
 <p id='n695' class='stm run hide_run'><a href='#n695'>695</a></p>
 <p id='n696' class='stm run hide_run'><a href='#n696'>696</a></p>
-<p id='n697' class='stm mis'><a href='#n697'>697</a></p>
-<p id='n698' class='stm mis'><a href='#n698'>698</a></p>
-<p id='n699' class='pln'><a href='#n699'>699</a></p>
-<p id='n700' class='stm run hide_run'><a href='#n700'>700</a></p>
-<p id='n701' class='stm mis'><a href='#n701'>701</a></p>
-<p id='n702' class='stm mis'><a href='#n702'>702</a></p>
+<p id='n697' class='stm run hide_run'><a href='#n697'>697</a></p>
+<p id='n698' class='stm run hide_run'><a href='#n698'>698</a></p>
+<p id='n699' class='stm mis'><a href='#n699'>699</a></p>
+<p id='n700' class='stm mis'><a href='#n700'>700</a></p>
+<p id='n701' class='pln'><a href='#n701'>701</a></p>
+<p id='n702' class='stm run hide_run'><a href='#n702'>702</a></p>
+<p id='n703' class='stm mis'><a href='#n703'>703</a></p>
+<p id='n704' class='stm mis'><a href='#n704'>704</a></p>
                 
             </td>
             <td class='text' valign='top'>
@@ -774,700 +776,702 @@ <h2 class='stats'>
 <p id='t6' class='pln'><span class='str'>with the matplotlylib package.</span><span class='strut'>&nbsp;</span></p>
 <p id='t7' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t8' class='pln'><span class='str'>&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t9' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>warnings</span><span class='strut'>&nbsp;</span></p>
+<p id='t9' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>__future__</span> <span class='key'>import</span> <span class='nam'>absolute_import</span><span class='strut'>&nbsp;</span></p>
 <p id='t10' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t11' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span> <span class='nam'>mplexporter</span> <span class='key'>import</span> <span class='nam'>Renderer</span><span class='strut'>&nbsp;</span></p>
-<p id='t12' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span> <span class='key'>import</span> <span class='nam'>mpltools</span><span class='strut'>&nbsp;</span></p>
-<p id='t13' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span><span class='op'>.</span><span class='nam'>graph_objs</span> <span class='key'>import</span> <span class='op'>*</span><span class='strut'>&nbsp;</span></p>
-<p id='t14' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t15' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t11' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>warnings</span><span class='strut'>&nbsp;</span></p>
+<p id='t12' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t13' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span> <span class='nam'>mplexporter</span> <span class='key'>import</span> <span class='nam'>Renderer</span><span class='strut'>&nbsp;</span></p>
+<p id='t14' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span> <span class='key'>import</span> <span class='nam'>mpltools</span><span class='strut'>&nbsp;</span></p>
+<p id='t15' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>plotly</span><span class='op'>.</span><span class='nam'>graph_objs</span> <span class='key'>import</span> <span class='op'>*</span><span class='strut'>&nbsp;</span></p>
 <p id='t16' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t17' class='pln'><span class='com'># Warning format</span><span class='strut'>&nbsp;</span></p>
-<p id='t18' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>warning_on_one_line</span><span class='op'>(</span><span class='nam'>message</span><span class='op'>,</span> <span class='nam'>category</span><span class='op'>,</span> <span class='nam'>filename</span><span class='op'>,</span> <span class='nam'>lineno</span><span class='op'>,</span> <span class='nam'>file</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>line</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t19' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='str'>&#39;%s:%s: %s:\n\n%s\n\n&#39;</span> <span class='op'>%</span> <span class='op'>(</span><span class='nam'>filename</span><span class='op'>,</span> <span class='nam'>lineno</span><span class='op'>,</span> <span class='nam'>category</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>,</span> <span class='nam'>message</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t20' class='stm run hide_run'><span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>formatwarning</span> <span class='op'>=</span> <span class='nam'>warning_on_one_line</span><span class='strut'>&nbsp;</span></p>
-<p id='t21' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t22' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>PlotlyRenderer</span><span class='op'>(</span><span class='nam'>Renderer</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t23' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A renderer class inheriting from base for rendering mpl plots in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t24' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t25' class='pln'><span class='str'>&nbsp; &nbsp; A renderer class to be used with an exporter for rendering matplotlib</span><span class='strut'>&nbsp;</span></p>
-<p id='t26' class='pln'><span class='str'>&nbsp; &nbsp; plots in Plotly. This module defines the PlotlyRenderer class which handles</span><span class='strut'>&nbsp;</span></p>
-<p id='t27' class='pln'><span class='str'>&nbsp; &nbsp; the creation of the JSON structures that get sent to plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t28' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t29' class='pln'><span class='str'>&nbsp; &nbsp; All class attributes available are defined in __init__().</span><span class='strut'>&nbsp;</span></p>
+<p id='t17' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t18' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t19' class='pln'><span class='com'># Warning format</span><span class='strut'>&nbsp;</span></p>
+<p id='t20' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>warning_on_one_line</span><span class='op'>(</span><span class='nam'>message</span><span class='op'>,</span> <span class='nam'>category</span><span class='op'>,</span> <span class='nam'>filename</span><span class='op'>,</span> <span class='nam'>lineno</span><span class='op'>,</span> <span class='nam'>file</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>line</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t21' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='str'>&#39;%s:%s: %s:\n\n%s\n\n&#39;</span> <span class='op'>%</span> <span class='op'>(</span><span class='nam'>filename</span><span class='op'>,</span> <span class='nam'>lineno</span><span class='op'>,</span> <span class='nam'>category</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>,</span> <span class='nam'>message</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t22' class='stm run hide_run'><span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>formatwarning</span> <span class='op'>=</span> <span class='nam'>warning_on_one_line</span><span class='strut'>&nbsp;</span></p>
+<p id='t23' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t24' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>PlotlyRenderer</span><span class='op'>(</span><span class='nam'>Renderer</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t25' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;A renderer class inheriting from base for rendering mpl plots in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t26' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t27' class='pln'><span class='str'>&nbsp; &nbsp; A renderer class to be used with an exporter for rendering matplotlib</span><span class='strut'>&nbsp;</span></p>
+<p id='t28' class='pln'><span class='str'>&nbsp; &nbsp; plots in Plotly. This module defines the PlotlyRenderer class which handles</span><span class='strut'>&nbsp;</span></p>
+<p id='t29' class='pln'><span class='str'>&nbsp; &nbsp; the creation of the JSON structures that get sent to plotly.</span><span class='strut'>&nbsp;</span></p>
 <p id='t30' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t31' class='pln'><span class='str'>&nbsp; &nbsp; Basic Usage:</span><span class='strut'>&nbsp;</span></p>
+<p id='t31' class='pln'><span class='str'>&nbsp; &nbsp; All class attributes available are defined in __init__().</span><span class='strut'>&nbsp;</span></p>
 <p id='t32' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t33' class='pln'><span class='str'>&nbsp; &nbsp; # (mpl code) #</span><span class='strut'>&nbsp;</span></p>
-<p id='t34' class='pln'><span class='str'>&nbsp; &nbsp; fig = gcf()</span><span class='strut'>&nbsp;</span></p>
-<p id='t35' class='pln'><span class='str'>&nbsp; &nbsp; renderer = PlotlyRenderer(fig)</span><span class='strut'>&nbsp;</span></p>
-<p id='t36' class='pln'><span class='str'>&nbsp; &nbsp; exporter = Exporter(renderer)</span><span class='strut'>&nbsp;</span></p>
-<p id='t37' class='pln'><span class='str'>&nbsp; &nbsp; exporter.run(fig)&nbsp; # ... et voila</span><span class='strut'>&nbsp;</span></p>
-<p id='t38' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t39' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t40' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t41' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Initialize PlotlyRenderer obj.</span><span class='strut'>&nbsp;</span></p>
-<p id='t42' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t43' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; PlotlyRenderer obj is called on by an Exporter object to draw</span><span class='strut'>&nbsp;</span></p>
-<p id='t44' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; matplotlib objects like figures, axes, text, etc.</span><span class='strut'>&nbsp;</span></p>
-<p id='t45' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t46' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; All class attributes are listed here in the __init__ method.</span><span class='strut'>&nbsp;</span></p>
+<p id='t33' class='pln'><span class='str'>&nbsp; &nbsp; Basic Usage:</span><span class='strut'>&nbsp;</span></p>
+<p id='t34' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t35' class='pln'><span class='str'>&nbsp; &nbsp; # (mpl code) #</span><span class='strut'>&nbsp;</span></p>
+<p id='t36' class='pln'><span class='str'>&nbsp; &nbsp; fig = gcf()</span><span class='strut'>&nbsp;</span></p>
+<p id='t37' class='pln'><span class='str'>&nbsp; &nbsp; renderer = PlotlyRenderer(fig)</span><span class='strut'>&nbsp;</span></p>
+<p id='t38' class='pln'><span class='str'>&nbsp; &nbsp; exporter = Exporter(renderer)</span><span class='strut'>&nbsp;</span></p>
+<p id='t39' class='pln'><span class='str'>&nbsp; &nbsp; exporter.run(fig)&nbsp; # ... et voila</span><span class='strut'>&nbsp;</span></p>
+<p id='t40' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t41' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t42' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t43' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Initialize PlotlyRenderer obj.</span><span class='strut'>&nbsp;</span></p>
+<p id='t44' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t45' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; PlotlyRenderer obj is called on by an Exporter object to draw</span><span class='strut'>&nbsp;</span></p>
+<p id='t46' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; matplotlib objects like figures, axes, text, etc.</span><span class='strut'>&nbsp;</span></p>
 <p id='t47' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t48' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t49' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span> <span class='op'>=</span> <span class='nam'>Figure</span><span class='op'>(</span><span class='nam'>data</span><span class='op'>=</span><span class='nam'>Data</span><span class='op'>(</span><span class='op'>)</span><span class='op'>,</span> <span class='nam'>layout</span><span class='op'>=</span><span class='nam'>Layout</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t50' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_fig</span> <span class='op'>=</span> <span class='nam'>None</span><span class='strut'>&nbsp;</span></p>
-<p id='t51' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span> <span class='op'>=</span> <span class='op'>[</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t52' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span> <span class='op'>=</span> <span class='num'>0</span><span class='strut'>&nbsp;</span></p>
-<p id='t53' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_x_bounds</span> <span class='op'>=</span> <span class='op'>(</span><span class='num'>0</span><span class='op'>,</span> <span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t54' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_y_bounds</span> <span class='op'>=</span> <span class='op'>(</span><span class='num'>0</span><span class='op'>,</span> <span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t55' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>=</span> <span class='str'>&quot;Initialized PlotlyRenderer\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t56' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t57' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>open_figure</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>fig</span><span class='op'>,</span> <span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t58' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Creates a new figure by beginning to fill out layout dict.</span><span class='strut'>&nbsp;</span></p>
-<p id='t59' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t60' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The &#39;autosize&#39; key is set to false so that the figure will mirror</span><span class='strut'>&nbsp;</span></p>
-<p id='t61' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; sizes set by mpl. The &#39;hovermode&#39; key controls what shows up when you</span><span class='strut'>&nbsp;</span></p>
-<p id='t62' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; mouse around a figure in plotly, it&#39;s set to show the &#39;closest&#39; point.</span><span class='strut'>&nbsp;</span></p>
-<p id='t63' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t64' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Positional agurments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t65' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; fig -- a matplotlib.figure.Figure object.</span><span class='strut'>&nbsp;</span></p>
-<p id='t66' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys(): [</span><span class='strut'>&nbsp;</span></p>
-<p id='t67' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;figwidth&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t68' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;figheight&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t69' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;dpi&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t70' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t71' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t72' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t73' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;Opening figure\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t74' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_fig</span> <span class='op'>=</span> <span class='nam'>fig</span><span class='strut'>&nbsp;</span></p>
-<p id='t75' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>Layout</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t76' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width</span><span class='op'>=</span><span class='nam'>int</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;figwidth&#39;</span><span class='op'>]</span><span class='op'>*</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;dpi&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t77' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>height</span><span class='op'>=</span><span class='nam'>int</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;figheight&#39;</span><span class='op'>]</span><span class='op'>*</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;dpi&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t78' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>autosize</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t79' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>hovermode</span><span class='op'>=</span><span class='str'>&#39;closest&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t80' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_x_bounds</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_y_bounds</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_axes_bounds</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t81' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>margin</span> <span class='op'>=</span> <span class='nam'>Margin</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t82' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>l</span><span class='op'>=</span><span class='nam'>int</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_x_bounds</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>*</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;width&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t83' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>r</span><span class='op'>=</span><span class='nam'>int</span><span class='op'>(</span><span class='op'>(</span><span class='num'>1</span><span class='op'>-</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_x_bounds</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span><span class='op'>)</span><span class='op'>*</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;width&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t84' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>t</span><span class='op'>=</span><span class='nam'>int</span><span class='op'>(</span><span class='op'>(</span><span class='num'>1</span><span class='op'>-</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_y_bounds</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span><span class='op'>)</span><span class='op'>*</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;height&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t85' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>b</span><span class='op'>=</span><span class='nam'>int</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_y_bounds</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>*</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;height&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t86' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pad</span><span class='op'>=</span><span class='num'>0</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t87' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;margin&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>margin</span><span class='strut'>&nbsp;</span></p>
-<p id='t88' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t89' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>close_figure</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>fig</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t90' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Closes figure by cleaning up data and layout dictionaries.</span><span class='strut'>&nbsp;</span></p>
-<p id='t91' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t92' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The PlotlyRenderer&#39;s job is to create an appropriate set of data and</span><span class='strut'>&nbsp;</span></p>
-<p id='t93' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; layout dictionaries. When the figure is closed, some cleanup and</span><span class='strut'>&nbsp;</span></p>
-<p id='t94' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; repair is necessary. This method removes inappropriate dictionary</span><span class='strut'>&nbsp;</span></p>
-<p id='t95' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; entries, freeing up Plotly to use defaults and best judgements to</span><span class='strut'>&nbsp;</span></p>
-<p id='t96' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; complete the entries. This method is called by an Exporter object.</span><span class='strut'>&nbsp;</span></p>
-<p id='t97' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t98' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t99' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; fig -- a matplotlib.figure.Figure object.</span><span class='strut'>&nbsp;</span></p>
-<p id='t100' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t101' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t102' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>.</span><span class='nam'>force_clean</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t103' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;showlegend&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>False</span><span class='strut'>&nbsp;</span></p>
-<p id='t104' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;Closing figure\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t105' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t106' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>open_axes</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>ax</span><span class='op'>,</span> <span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t107' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Setup a new axes object (subplot in plotly).</span><span class='strut'>&nbsp;</span></p>
-<p id='t108' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t109' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Plotly stores information about subplots in different &#39;xaxis&#39; and</span><span class='strut'>&nbsp;</span></p>
-<p id='t110' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;yaxis&#39; objects which are numbered. These are just dictionaries</span><span class='strut'>&nbsp;</span></p>
-<p id='t111' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; included in the layout dictionary. This function takes information</span><span class='strut'>&nbsp;</span></p>
-<p id='t112' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; from the Exporter, fills in appropriate dictionary entries,</span><span class='strut'>&nbsp;</span></p>
-<p id='t113' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; and updates the layout dictionary. PlotlyRenderer keeps track of the</span><span class='strut'>&nbsp;</span></p>
-<p id='t114' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; number of plots by incrementing the axis_ct attribute.</span><span class='strut'>&nbsp;</span></p>
-<p id='t115' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t116' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Setting the proper plot domain in plotly is a bit tricky. Refer to</span><span class='strut'>&nbsp;</span></p>
-<p id='t117' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; the documentation for mpltools.convert_x_domain and</span><span class='strut'>&nbsp;</span></p>
-<p id='t118' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; mpltools.convert_y_domain.</span><span class='strut'>&nbsp;</span></p>
-<p id='t119' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t120' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t121' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ax -- an mpl axes object. This will become a subplot in plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t122' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t123' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;axesbg&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (background color for axes obj)</span><span class='strut'>&nbsp;</span></p>
-<p id='t124' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;axesbgalpha&#39;,&nbsp; &nbsp; &nbsp; (alpha, or opacity for background)</span><span class='strut'>&nbsp;</span></p>
-<p id='t125' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;bounds&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; ((x0, y0, width, height) for axes)</span><span class='strut'>&nbsp;</span></p>
-<p id='t126' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;dynamic&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (zoom/pan-able?)</span><span class='strut'>&nbsp;</span></p>
-<p id='t127' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;axes&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (list: [xaxis, yaxis])</span><span class='strut'>&nbsp;</span></p>
-<p id='t128' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;xscale&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (log, linear, or date)</span><span class='strut'>&nbsp;</span></p>
-<p id='t129' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;yscale&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t130' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;xlim&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (range limits for x)</span><span class='strut'>&nbsp;</span></p>
-<p id='t131' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;ylim&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t132' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;xdomain&#39;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (xdomain=xlim, unless it&#39;s a date)</span><span class='strut'>&nbsp;</span></p>
-<p id='t133' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;ydomain&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t134' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t135' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t136' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t137' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; Opening axes\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t138' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
-<p id='t139' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># set defaults in axes</span><span class='strut'>&nbsp;</span></p>
-<p id='t140' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span> <span class='op'>=</span> <span class='nam'>XAxis</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t141' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>anchor</span><span class='op'>=</span><span class='str'>&#39;y{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t142' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>zeroline</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t143' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ticks</span><span class='op'>=</span><span class='str'>&#39;inside&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t144' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span> <span class='op'>=</span> <span class='nam'>YAxis</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t145' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>anchor</span><span class='op'>=</span><span class='str'>&#39;x{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t146' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>zeroline</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t147' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ticks</span><span class='op'>=</span><span class='str'>&#39;inside&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t148' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># update defaults with things set in mpl</span><span class='strut'>&nbsp;</span></p>
-<p id='t149' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>mpl_xaxis</span><span class='op'>,</span> <span class='nam'>mpl_yaxis</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>prep_xy_axis</span><span class='op'>(</span><span class='nam'>ax</span><span class='op'>=</span><span class='nam'>ax</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t150' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>props</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t151' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>x_bounds</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_x_bounds</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t152' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>y_bounds</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_y_bounds</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t153' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>mpl_xaxis</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t154' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>mpl_yaxis</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t155' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>bottom_spine</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_spine_visible</span><span class='op'>(</span><span class='nam'>ax</span><span class='op'>,</span> <span class='str'>&#39;bottom&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t156' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>top_spine</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_spine_visible</span><span class='op'>(</span><span class='nam'>ax</span><span class='op'>,</span> <span class='str'>&#39;top&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t157' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>left_spine</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_spine_visible</span><span class='op'>(</span><span class='nam'>ax</span><span class='op'>,</span> <span class='str'>&#39;left&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t158' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>right_spine</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_spine_visible</span><span class='op'>(</span><span class='nam'>ax</span><span class='op'>,</span> <span class='str'>&#39;right&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t159' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span><span class='op'>[</span><span class='str'>&#39;mirror&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_axis_mirror</span><span class='op'>(</span><span class='nam'>bottom_spine</span><span class='op'>,</span> <span class='nam'>top_spine</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t160' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span><span class='op'>[</span><span class='str'>&#39;mirror&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_axis_mirror</span><span class='op'>(</span><span class='nam'>left_spine</span><span class='op'>,</span> <span class='nam'>right_spine</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t161' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span><span class='op'>[</span><span class='str'>&#39;showline&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>bottom_spine</span><span class='strut'>&nbsp;</span></p>
-<p id='t162' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span><span class='op'>[</span><span class='str'>&#39;showline&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>top_spine</span><span class='strut'>&nbsp;</span></p>
-<p id='t163' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t164' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t165' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># put axes in our figure</span><span class='strut'>&nbsp;</span></p>
-<p id='t166' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;xaxis{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>xaxis</span><span class='strut'>&nbsp;</span></p>
-<p id='t167' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;yaxis{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>yaxis</span><span class='strut'>&nbsp;</span></p>
-<p id='t168' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t169' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>close_axes</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>ax</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t170' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Close the axes object and clean up.</span><span class='strut'>&nbsp;</span></p>
-<p id='t171' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t172' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Bars from bar charts are given to PlotlyRenderer one-by-one,</span><span class='strut'>&nbsp;</span></p>
-<p id='t173' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; thus they need to be taken care of at the close of each axes object.</span><span class='strut'>&nbsp;</span></p>
-<p id='t174' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The self.current_ax_patches variable should be empty unless a bar</span><span class='strut'>&nbsp;</span></p>
-<p id='t175' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; chart has been created or a rectangle object has been drawn that has</span><span class='strut'>&nbsp;</span></p>
-<p id='t176' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; an edge exactly on the lines x=0 or y=0.</span><span class='strut'>&nbsp;</span></p>
-<p id='t177' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t178' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t179' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ax -- an mpl axes object, not required at this time.</span><span class='strut'>&nbsp;</span></p>
-<p id='t180' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t181' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t182' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>patch_coll</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t183' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>draw_bar</span><span class='op'>(</span><span class='nam'>patch_coll</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t184' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span> <span class='op'>=</span> <span class='op'>[</span><span class='op'>]</span>&nbsp; <span class='com'># clear this for next axes obj</span><span class='strut'>&nbsp;</span></p>
-<p id='t185' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; Closing axes\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t186' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t187' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_bar</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>patch_coll</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t188' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Draw a collection of similar patches as a bar chart.</span><span class='strut'>&nbsp;</span></p>
-<p id='t189' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t190' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; After bars are sorted, an appropriate data dictionary must be created</span><span class='strut'>&nbsp;</span></p>
-<p id='t191' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; to tell plotly about this data. Just like draw_line or draw_markers,</span><span class='strut'>&nbsp;</span></p>
-<p id='t192' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; draw_bar translates patch/path information into something plotly</span><span class='strut'>&nbsp;</span></p>
-<p id='t193' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; understands.</span><span class='strut'>&nbsp;</span></p>
-<p id='t194' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t195' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t196' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; patch_coll -- a collection of patches to be drawn as a bar chart.</span><span class='strut'>&nbsp;</span></p>
-<p id='t197' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t198' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t199' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>orientation</span> <span class='op'>=</span> <span class='nam'>patch_coll</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;orientation&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t200' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>orientation</span> <span class='op'>==</span> <span class='str'>&#39;v&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t201' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw a vertical bar chart\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t202' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>patch_coll</span><span class='op'>.</span><span class='nam'>sort</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>=</span><span class='key'>lambda</span> <span class='nam'>b</span><span class='op'>:</span> <span class='nam'>b</span><span class='op'>[</span><span class='str'>&#39;x0&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t203' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x0&#39;</span><span class='op'>]</span><span class='op'>+</span><span class='op'>(</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x1&#39;</span><span class='op'>]</span><span class='op'>-</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x0&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>/</span><span class='num'>2</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t204' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;y1&#39;</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t205' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>bar_gap</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_bar_gap</span><span class='op'>(</span><span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x0&#39;</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t206' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x1&#39;</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t207' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t208' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw a horizontal bar chart\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t209' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>patch_coll</span><span class='op'>.</span><span class='nam'>sort</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>=</span><span class='key'>lambda</span> <span class='nam'>b</span><span class='op'>:</span> <span class='nam'>b</span><span class='op'>[</span><span class='str'>&#39;y0&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t210' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x1&#39;</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t211' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;y0&#39;</span><span class='op'>]</span><span class='op'>+</span><span class='op'>(</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;y1&#39;</span><span class='op'>]</span><span class='op'>-</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;y0&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>/</span><span class='num'>2</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t212' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>bar_gap</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_bar_gap</span><span class='op'>(</span><span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;y0&#39;</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t213' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;y1&#39;</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t214' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>bar</span> <span class='op'>=</span> <span class='nam'>Bar</span><span class='op'>(</span><span class='nam'>orientation</span><span class='op'>=</span><span class='nam'>orientation</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t215' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>=</span><span class='nam'>x</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t216' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y</span><span class='op'>=</span><span class='nam'>y</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t217' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span><span class='op'>=</span><span class='str'>&#39;x{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t218' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span><span class='op'>=</span><span class='str'>&#39;y{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t219' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>opacity</span><span class='op'>=</span><span class='nam'>patch_coll</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;alpha&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t220' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>marker</span><span class='op'>=</span><span class='nam'>Marker</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t221' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>patch_coll</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;facecolor&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t222' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>line</span><span class='op'>=</span><span class='nam'>Line</span><span class='op'>(</span><span class='nam'>width</span><span class='op'>=</span><span class='nam'>patch_coll</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;edgewidth&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t223' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x&#39;</span><span class='op'>]</span><span class='op'>)</span> <span class='op'>&gt;</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t224' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Heck yeah, I drew that bar chart\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t225' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span> <span class='op'>+=</span> <span class='nam'>bar</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t226' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>bar_gap</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t227' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;bargap&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>bar_gap</span><span class='strut'>&nbsp;</span></p>
-<p id='t228' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t229' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Bar chart not drawn\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t230' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&#39;found box chart data with length &lt;= 1, &#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t231' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;assuming data redundancy, not plotting.&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t232' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t233' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_marked_line</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t234' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Create a data dict for a line obj.</span><span class='strut'>&nbsp;</span></p>
-<p id='t235' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t236' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This will draw &#39;lines&#39;, &#39;markers&#39;, or &#39;lines+markers&#39;.</span><span class='strut'>&nbsp;</span></p>
+<p id='t48' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; All class attributes are listed here in the __init__ method.</span><span class='strut'>&nbsp;</span></p>
+<p id='t49' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t50' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t51' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span> <span class='op'>=</span> <span class='nam'>Figure</span><span class='op'>(</span><span class='nam'>data</span><span class='op'>=</span><span class='nam'>Data</span><span class='op'>(</span><span class='op'>)</span><span class='op'>,</span> <span class='nam'>layout</span><span class='op'>=</span><span class='nam'>Layout</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t52' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_fig</span> <span class='op'>=</span> <span class='nam'>None</span><span class='strut'>&nbsp;</span></p>
+<p id='t53' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span> <span class='op'>=</span> <span class='op'>[</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t54' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span> <span class='op'>=</span> <span class='num'>0</span><span class='strut'>&nbsp;</span></p>
+<p id='t55' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_x_bounds</span> <span class='op'>=</span> <span class='op'>(</span><span class='num'>0</span><span class='op'>,</span> <span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t56' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_y_bounds</span> <span class='op'>=</span> <span class='op'>(</span><span class='num'>0</span><span class='op'>,</span> <span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t57' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>=</span> <span class='str'>&quot;Initialized PlotlyRenderer\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t58' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t59' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>open_figure</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>fig</span><span class='op'>,</span> <span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t60' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Creates a new figure by beginning to fill out layout dict.</span><span class='strut'>&nbsp;</span></p>
+<p id='t61' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t62' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The &#39;autosize&#39; key is set to false so that the figure will mirror</span><span class='strut'>&nbsp;</span></p>
+<p id='t63' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; sizes set by mpl. The &#39;hovermode&#39; key controls what shows up when you</span><span class='strut'>&nbsp;</span></p>
+<p id='t64' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; mouse around a figure in plotly, it&#39;s set to show the &#39;closest&#39; point.</span><span class='strut'>&nbsp;</span></p>
+<p id='t65' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t66' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Positional agurments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t67' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; fig -- a matplotlib.figure.Figure object.</span><span class='strut'>&nbsp;</span></p>
+<p id='t68' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys(): [</span><span class='strut'>&nbsp;</span></p>
+<p id='t69' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;figwidth&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t70' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;figheight&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t71' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;dpi&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t72' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t73' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t74' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t75' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;Opening figure\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t76' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_fig</span> <span class='op'>=</span> <span class='nam'>fig</span><span class='strut'>&nbsp;</span></p>
+<p id='t77' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>Layout</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t78' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width</span><span class='op'>=</span><span class='nam'>int</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;figwidth&#39;</span><span class='op'>]</span><span class='op'>*</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;dpi&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t79' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>height</span><span class='op'>=</span><span class='nam'>int</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;figheight&#39;</span><span class='op'>]</span><span class='op'>*</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;dpi&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t80' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>autosize</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t81' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>hovermode</span><span class='op'>=</span><span class='str'>&#39;closest&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t82' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_x_bounds</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_y_bounds</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_axes_bounds</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t83' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>margin</span> <span class='op'>=</span> <span class='nam'>Margin</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t84' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>l</span><span class='op'>=</span><span class='nam'>int</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_x_bounds</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>*</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;width&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t85' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>r</span><span class='op'>=</span><span class='nam'>int</span><span class='op'>(</span><span class='op'>(</span><span class='num'>1</span><span class='op'>-</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_x_bounds</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span><span class='op'>)</span><span class='op'>*</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;width&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t86' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>t</span><span class='op'>=</span><span class='nam'>int</span><span class='op'>(</span><span class='op'>(</span><span class='num'>1</span><span class='op'>-</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_y_bounds</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span><span class='op'>)</span><span class='op'>*</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;height&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t87' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>b</span><span class='op'>=</span><span class='nam'>int</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_y_bounds</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>*</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;height&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t88' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>pad</span><span class='op'>=</span><span class='num'>0</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t89' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;margin&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>margin</span><span class='strut'>&nbsp;</span></p>
+<p id='t90' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t91' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>close_figure</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>fig</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t92' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Closes figure by cleaning up data and layout dictionaries.</span><span class='strut'>&nbsp;</span></p>
+<p id='t93' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t94' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The PlotlyRenderer&#39;s job is to create an appropriate set of data and</span><span class='strut'>&nbsp;</span></p>
+<p id='t95' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; layout dictionaries. When the figure is closed, some cleanup and</span><span class='strut'>&nbsp;</span></p>
+<p id='t96' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; repair is necessary. This method removes inappropriate dictionary</span><span class='strut'>&nbsp;</span></p>
+<p id='t97' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; entries, freeing up Plotly to use defaults and best judgements to</span><span class='strut'>&nbsp;</span></p>
+<p id='t98' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; complete the entries. This method is called by an Exporter object.</span><span class='strut'>&nbsp;</span></p>
+<p id='t99' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t100' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t101' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; fig -- a matplotlib.figure.Figure object.</span><span class='strut'>&nbsp;</span></p>
+<p id='t102' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t103' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t104' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>.</span><span class='nam'>force_clean</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t105' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;showlegend&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>False</span><span class='strut'>&nbsp;</span></p>
+<p id='t106' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;Closing figure\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t107' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t108' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>open_axes</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>ax</span><span class='op'>,</span> <span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t109' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Setup a new axes object (subplot in plotly).</span><span class='strut'>&nbsp;</span></p>
+<p id='t110' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t111' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Plotly stores information about subplots in different &#39;xaxis&#39; and</span><span class='strut'>&nbsp;</span></p>
+<p id='t112' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;yaxis&#39; objects which are numbered. These are just dictionaries</span><span class='strut'>&nbsp;</span></p>
+<p id='t113' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; included in the layout dictionary. This function takes information</span><span class='strut'>&nbsp;</span></p>
+<p id='t114' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; from the Exporter, fills in appropriate dictionary entries,</span><span class='strut'>&nbsp;</span></p>
+<p id='t115' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; and updates the layout dictionary. PlotlyRenderer keeps track of the</span><span class='strut'>&nbsp;</span></p>
+<p id='t116' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; number of plots by incrementing the axis_ct attribute.</span><span class='strut'>&nbsp;</span></p>
+<p id='t117' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t118' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Setting the proper plot domain in plotly is a bit tricky. Refer to</span><span class='strut'>&nbsp;</span></p>
+<p id='t119' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; the documentation for mpltools.convert_x_domain and</span><span class='strut'>&nbsp;</span></p>
+<p id='t120' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; mpltools.convert_y_domain.</span><span class='strut'>&nbsp;</span></p>
+<p id='t121' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t122' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t123' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ax -- an mpl axes object. This will become a subplot in plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t124' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t125' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;axesbg&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (background color for axes obj)</span><span class='strut'>&nbsp;</span></p>
+<p id='t126' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;axesbgalpha&#39;,&nbsp; &nbsp; &nbsp; (alpha, or opacity for background)</span><span class='strut'>&nbsp;</span></p>
+<p id='t127' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;bounds&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; ((x0, y0, width, height) for axes)</span><span class='strut'>&nbsp;</span></p>
+<p id='t128' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;dynamic&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (zoom/pan-able?)</span><span class='strut'>&nbsp;</span></p>
+<p id='t129' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;axes&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (list: [xaxis, yaxis])</span><span class='strut'>&nbsp;</span></p>
+<p id='t130' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;xscale&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (log, linear, or date)</span><span class='strut'>&nbsp;</span></p>
+<p id='t131' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;yscale&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t132' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;xlim&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (range limits for x)</span><span class='strut'>&nbsp;</span></p>
+<p id='t133' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;ylim&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t134' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;xdomain&#39;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (xdomain=xlim, unless it&#39;s a date)</span><span class='strut'>&nbsp;</span></p>
+<p id='t135' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;ydomain&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t136' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t137' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t138' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t139' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; Opening axes\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t140' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
+<p id='t141' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># set defaults in axes</span><span class='strut'>&nbsp;</span></p>
+<p id='t142' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span> <span class='op'>=</span> <span class='nam'>XAxis</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t143' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>anchor</span><span class='op'>=</span><span class='str'>&#39;y{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t144' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>zeroline</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t145' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ticks</span><span class='op'>=</span><span class='str'>&#39;inside&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t146' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span> <span class='op'>=</span> <span class='nam'>YAxis</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t147' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>anchor</span><span class='op'>=</span><span class='str'>&#39;x{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t148' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>zeroline</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t149' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ticks</span><span class='op'>=</span><span class='str'>&#39;inside&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t150' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># update defaults with things set in mpl</span><span class='strut'>&nbsp;</span></p>
+<p id='t151' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>mpl_xaxis</span><span class='op'>,</span> <span class='nam'>mpl_yaxis</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>prep_xy_axis</span><span class='op'>(</span><span class='nam'>ax</span><span class='op'>=</span><span class='nam'>ax</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t152' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>props</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t153' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>x_bounds</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_x_bounds</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t154' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>y_bounds</span><span class='op'>=</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_y_bounds</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t155' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>mpl_xaxis</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t156' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>mpl_yaxis</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t157' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>bottom_spine</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_spine_visible</span><span class='op'>(</span><span class='nam'>ax</span><span class='op'>,</span> <span class='str'>&#39;bottom&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t158' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>top_spine</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_spine_visible</span><span class='op'>(</span><span class='nam'>ax</span><span class='op'>,</span> <span class='str'>&#39;top&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t159' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>left_spine</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_spine_visible</span><span class='op'>(</span><span class='nam'>ax</span><span class='op'>,</span> <span class='str'>&#39;left&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t160' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>right_spine</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_spine_visible</span><span class='op'>(</span><span class='nam'>ax</span><span class='op'>,</span> <span class='str'>&#39;right&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t161' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span><span class='op'>[</span><span class='str'>&#39;mirror&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_axis_mirror</span><span class='op'>(</span><span class='nam'>bottom_spine</span><span class='op'>,</span> <span class='nam'>top_spine</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t162' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span><span class='op'>[</span><span class='str'>&#39;mirror&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_axis_mirror</span><span class='op'>(</span><span class='nam'>left_spine</span><span class='op'>,</span> <span class='nam'>right_spine</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t163' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span><span class='op'>[</span><span class='str'>&#39;showline&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>bottom_spine</span><span class='strut'>&nbsp;</span></p>
+<p id='t164' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span><span class='op'>[</span><span class='str'>&#39;showline&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>top_spine</span><span class='strut'>&nbsp;</span></p>
+<p id='t165' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t166' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t167' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># put axes in our figure</span><span class='strut'>&nbsp;</span></p>
+<p id='t168' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;xaxis{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>xaxis</span><span class='strut'>&nbsp;</span></p>
+<p id='t169' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;yaxis{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>yaxis</span><span class='strut'>&nbsp;</span></p>
+<p id='t170' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t171' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>close_axes</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>ax</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t172' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Close the axes object and clean up.</span><span class='strut'>&nbsp;</span></p>
+<p id='t173' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t174' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Bars from bar charts are given to PlotlyRenderer one-by-one,</span><span class='strut'>&nbsp;</span></p>
+<p id='t175' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; thus they need to be taken care of at the close of each axes object.</span><span class='strut'>&nbsp;</span></p>
+<p id='t176' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The self.current_ax_patches variable should be empty unless a bar</span><span class='strut'>&nbsp;</span></p>
+<p id='t177' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; chart has been created or a rectangle object has been drawn that has</span><span class='strut'>&nbsp;</span></p>
+<p id='t178' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; an edge exactly on the lines x=0 or y=0.</span><span class='strut'>&nbsp;</span></p>
+<p id='t179' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t180' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t181' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ax -- an mpl axes object, not required at this time.</span><span class='strut'>&nbsp;</span></p>
+<p id='t182' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t183' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t184' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>patch_coll</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t185' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>draw_bar</span><span class='op'>(</span><span class='nam'>patch_coll</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t186' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span> <span class='op'>=</span> <span class='op'>[</span><span class='op'>]</span>&nbsp; <span class='com'># clear this for next axes obj</span><span class='strut'>&nbsp;</span></p>
+<p id='t187' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; Closing axes\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t188' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t189' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_bar</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>patch_coll</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t190' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Draw a collection of similar patches as a bar chart.</span><span class='strut'>&nbsp;</span></p>
+<p id='t191' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t192' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; After bars are sorted, an appropriate data dictionary must be created</span><span class='strut'>&nbsp;</span></p>
+<p id='t193' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; to tell plotly about this data. Just like draw_line or draw_markers,</span><span class='strut'>&nbsp;</span></p>
+<p id='t194' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; draw_bar translates patch/path information into something plotly</span><span class='strut'>&nbsp;</span></p>
+<p id='t195' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; understands.</span><span class='strut'>&nbsp;</span></p>
+<p id='t196' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t197' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t198' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; patch_coll -- a collection of patches to be drawn as a bar chart.</span><span class='strut'>&nbsp;</span></p>
+<p id='t199' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t200' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t201' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>orientation</span> <span class='op'>=</span> <span class='nam'>patch_coll</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;orientation&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t202' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>orientation</span> <span class='op'>==</span> <span class='str'>&#39;v&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t203' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw a vertical bar chart\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t204' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>patch_coll</span><span class='op'>.</span><span class='nam'>sort</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>=</span><span class='key'>lambda</span> <span class='nam'>b</span><span class='op'>:</span> <span class='nam'>b</span><span class='op'>[</span><span class='str'>&#39;x0&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t205' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x0&#39;</span><span class='op'>]</span><span class='op'>+</span><span class='op'>(</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x1&#39;</span><span class='op'>]</span><span class='op'>-</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x0&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>/</span><span class='num'>2</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t206' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;y1&#39;</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t207' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>bar_gap</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_bar_gap</span><span class='op'>(</span><span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x0&#39;</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t208' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x1&#39;</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t209' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t210' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw a horizontal bar chart\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t211' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>patch_coll</span><span class='op'>.</span><span class='nam'>sort</span><span class='op'>(</span><span class='nam'>key</span><span class='op'>=</span><span class='key'>lambda</span> <span class='nam'>b</span><span class='op'>:</span> <span class='nam'>b</span><span class='op'>[</span><span class='str'>&#39;y0&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t212' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x1&#39;</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t213' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y</span> <span class='op'>=</span> <span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;y0&#39;</span><span class='op'>]</span><span class='op'>+</span><span class='op'>(</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;y1&#39;</span><span class='op'>]</span><span class='op'>-</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;y0&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>/</span><span class='num'>2</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t214' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>bar_gap</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_bar_gap</span><span class='op'>(</span><span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;y0&#39;</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t215' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='op'>[</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;y1&#39;</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>bar</span> <span class='key'>in</span> <span class='nam'>patch_coll</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t216' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>bar</span> <span class='op'>=</span> <span class='nam'>Bar</span><span class='op'>(</span><span class='nam'>orientation</span><span class='op'>=</span><span class='nam'>orientation</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t217' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>=</span><span class='nam'>x</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t218' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y</span><span class='op'>=</span><span class='nam'>y</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t219' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span><span class='op'>=</span><span class='str'>&#39;x{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t220' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span><span class='op'>=</span><span class='str'>&#39;y{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t221' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>opacity</span><span class='op'>=</span><span class='nam'>patch_coll</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;alpha&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t222' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>marker</span><span class='op'>=</span><span class='nam'>Marker</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t223' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>patch_coll</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;facecolor&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t224' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>line</span><span class='op'>=</span><span class='nam'>Line</span><span class='op'>(</span><span class='nam'>width</span><span class='op'>=</span><span class='nam'>patch_coll</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;edgewidth&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t225' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>bar</span><span class='op'>[</span><span class='str'>&#39;x&#39;</span><span class='op'>]</span><span class='op'>)</span> <span class='op'>&gt;</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t226' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Heck yeah, I drew that bar chart\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t227' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span> <span class='op'>+=</span> <span class='nam'>bar</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t228' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>bar_gap</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t229' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;bargap&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>bar_gap</span><span class='strut'>&nbsp;</span></p>
+<p id='t230' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t231' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Bar chart not drawn\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t232' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&#39;found box chart data with length &lt;= 1, &#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t233' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;assuming data redundancy, not plotting.&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t234' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t235' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_marked_line</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t236' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Create a data dict for a line obj.</span><span class='strut'>&nbsp;</span></p>
 <p id='t237' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t238' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t239' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;coordinates&#39;,&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, or &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t240' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;data&#39;,&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (a list of xy pairs)</span><span class='strut'>&nbsp;</span></p>
-<p id='t241' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (the matplotlib.lines.Line2D obj being rendered)</span><span class='strut'>&nbsp;</span></p>
-<p id='t242' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;label&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (the name of the Line2D obj being rendered)</span><span class='strut'>&nbsp;</span></p>
-<p id='t243' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;linestyle&#39;,&nbsp; &nbsp; (linestyle dict, can be None, see below)</span><span class='strut'>&nbsp;</span></p>
-<p id='t244' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;markerstyle&#39;,&nbsp; (markerstyle dict, can be None, see below)</span><span class='strut'>&nbsp;</span></p>
-<p id='t245' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t246' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t247' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;linestyle&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t248' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of Line2D obj)</span><span class='strut'>&nbsp;</span></p>
-<p id='t249' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;color&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (color of the line if it exists, not the marker)</span><span class='strut'>&nbsp;</span></p>
-<p id='t250' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;linewidth&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t251' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;dasharray&#39;,&nbsp; &nbsp; (code for linestyle, see DASH_MAP in mpltools.py)</span><span class='strut'>&nbsp;</span></p>
-<p id='t252' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (viewing precedence when stacked with other objects)</span><span class='strut'>&nbsp;</span></p>
-<p id='t253' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t254' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t255' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;markerstyle&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t256' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of Line2D obj)</span><span class='strut'>&nbsp;</span></p>
-<p id='t257' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;marker&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (the mpl marker symbol, see SYMBOL_MAP in mpltools.py)</span><span class='strut'>&nbsp;</span></p>
-<p id='t258' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;facecolor&#39;,&nbsp; &nbsp; (color of the marker face)</span><span class='strut'>&nbsp;</span></p>
-<p id='t259' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgecolor&#39;,&nbsp; &nbsp; (color of the marker edge)</span><span class='strut'>&nbsp;</span></p>
-<p id='t260' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgewidth&#39;,&nbsp; &nbsp; (width of marker edge)</span><span class='strut'>&nbsp;</span></p>
-<p id='t261' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;markerpath&#39;,&nbsp;&nbsp; (an SVG path for drawing the specified marker)</span><span class='strut'>&nbsp;</span></p>
-<p id='t262' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (viewing precedence when stacked with other objects)</span><span class='strut'>&nbsp;</span></p>
-<p id='t263' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t264' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t265' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t266' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw a line &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t267' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>line</span><span class='op'>,</span> <span class='nam'>marker</span> <span class='op'>=</span> <span class='op'>{</span><span class='op'>}</span><span class='op'>,</span> <span class='op'>{</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
-<p id='t268' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span> <span class='key'>and</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t269' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;... with both lines+markers\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t270' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>mode</span> <span class='op'>=</span> <span class='str'>&quot;lines+markers&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t271' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t272' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;... with just lines\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t273' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>mode</span> <span class='op'>=</span> <span class='str'>&quot;lines&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t274' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t275' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;... with just markers\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t276' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>mode</span> <span class='op'>=</span> <span class='str'>&quot;markers&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t277' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t278' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>line</span> <span class='op'>=</span> <span class='nam'>Line</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t279' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>opacity</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;alpha&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t280' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;color&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t281' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;linewidth&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t282' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>dash</span><span class='op'>=</span><span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>convert_dash</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;dasharray&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t283' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t284' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t285' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>marker</span> <span class='op'>=</span> <span class='nam'>Marker</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t286' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>opacity</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;alpha&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t287' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;facecolor&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t288' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>symbol</span><span class='op'>=</span><span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>convert_symbol</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;marker&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t289' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>size</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;markersize&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t290' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>line</span><span class='op'>=</span><span class='nam'>Line</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t291' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;edgecolor&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t292' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;edgewidth&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t293' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t294' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t295' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;coordinates&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;data&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t296' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>marked_line</span> <span class='op'>=</span> <span class='nam'>Scatter</span><span class='op'>(</span><span class='nam'>mode</span><span class='op'>=</span><span class='nam'>mode</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t297' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>name</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;label&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t298' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>=</span><span class='op'>[</span><span class='nam'>xy_pair</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>xy_pair</span> <span class='key'>in</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t299' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y</span><span class='op'>=</span><span class='op'>[</span><span class='nam'>xy_pair</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>xy_pair</span> <span class='key'>in</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t300' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span><span class='op'>=</span><span class='str'>&#39;x{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t301' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span><span class='op'>=</span><span class='str'>&#39;y{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t302' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>line</span><span class='op'>=</span><span class='nam'>line</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t303' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>marker</span><span class='op'>=</span><span class='nam'>marker</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t304' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span> <span class='op'>+=</span> <span class='nam'>marked_line</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t305' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Heck yeah, I drew that line\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t306' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t307' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Line didn&#39;t have &#39;data&#39; coordinates, &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
-<p id='t308' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;not drawing\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t309' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;Bummer! Plotly can currently only draw Line2D &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t310' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;objects from matplotlib that are in &#39;data&#39; &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t311' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;coordinates!&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t312' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t313' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_image</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t314' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Draw image.</span><span class='strut'>&nbsp;</span></p>
-<p id='t315' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t316' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Not implemented yet!</span><span class='strut'>&nbsp;</span></p>
+<p id='t238' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This will draw &#39;lines&#39;, &#39;markers&#39;, or &#39;lines+markers&#39;.</span><span class='strut'>&nbsp;</span></p>
+<p id='t239' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t240' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t241' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;coordinates&#39;,&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, or &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t242' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;data&#39;,&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (a list of xy pairs)</span><span class='strut'>&nbsp;</span></p>
+<p id='t243' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (the matplotlib.lines.Line2D obj being rendered)</span><span class='strut'>&nbsp;</span></p>
+<p id='t244' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;label&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (the name of the Line2D obj being rendered)</span><span class='strut'>&nbsp;</span></p>
+<p id='t245' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;linestyle&#39;,&nbsp; &nbsp; (linestyle dict, can be None, see below)</span><span class='strut'>&nbsp;</span></p>
+<p id='t246' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;markerstyle&#39;,&nbsp; (markerstyle dict, can be None, see below)</span><span class='strut'>&nbsp;</span></p>
+<p id='t247' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t248' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t249' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;linestyle&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t250' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of Line2D obj)</span><span class='strut'>&nbsp;</span></p>
+<p id='t251' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;color&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (color of the line if it exists, not the marker)</span><span class='strut'>&nbsp;</span></p>
+<p id='t252' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;linewidth&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t253' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;dasharray&#39;,&nbsp; &nbsp; (code for linestyle, see DASH_MAP in mpltools.py)</span><span class='strut'>&nbsp;</span></p>
+<p id='t254' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (viewing precedence when stacked with other objects)</span><span class='strut'>&nbsp;</span></p>
+<p id='t255' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t256' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t257' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;markerstyle&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t258' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of Line2D obj)</span><span class='strut'>&nbsp;</span></p>
+<p id='t259' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;marker&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (the mpl marker symbol, see SYMBOL_MAP in mpltools.py)</span><span class='strut'>&nbsp;</span></p>
+<p id='t260' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;facecolor&#39;,&nbsp; &nbsp; (color of the marker face)</span><span class='strut'>&nbsp;</span></p>
+<p id='t261' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgecolor&#39;,&nbsp; &nbsp; (color of the marker edge)</span><span class='strut'>&nbsp;</span></p>
+<p id='t262' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgewidth&#39;,&nbsp; &nbsp; (width of marker edge)</span><span class='strut'>&nbsp;</span></p>
+<p id='t263' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;markerpath&#39;,&nbsp;&nbsp; (an SVG path for drawing the specified marker)</span><span class='strut'>&nbsp;</span></p>
+<p id='t264' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (viewing precedence when stacked with other objects)</span><span class='strut'>&nbsp;</span></p>
+<p id='t265' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t266' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t267' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t268' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw a line &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t269' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>line</span><span class='op'>,</span> <span class='nam'>marker</span> <span class='op'>=</span> <span class='op'>{</span><span class='op'>}</span><span class='op'>,</span> <span class='op'>{</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
+<p id='t270' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span> <span class='key'>and</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t271' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;... with both lines+markers\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t272' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>mode</span> <span class='op'>=</span> <span class='str'>&quot;lines+markers&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t273' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t274' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;... with just lines\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t275' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>mode</span> <span class='op'>=</span> <span class='str'>&quot;lines&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t276' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t277' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;... with just markers\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t278' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>mode</span> <span class='op'>=</span> <span class='str'>&quot;markers&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t279' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t280' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>line</span> <span class='op'>=</span> <span class='nam'>Line</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t281' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>opacity</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;alpha&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t282' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;color&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t283' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;linewidth&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t284' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>dash</span><span class='op'>=</span><span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>convert_dash</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;linestyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;dasharray&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t285' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t286' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t287' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>marker</span> <span class='op'>=</span> <span class='nam'>Marker</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t288' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>opacity</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;alpha&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t289' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;facecolor&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t290' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>symbol</span><span class='op'>=</span><span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>convert_symbol</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;marker&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t291' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>size</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;markersize&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t292' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>line</span><span class='op'>=</span><span class='nam'>Line</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t293' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;edgecolor&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t294' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>width</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;markerstyle&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;edgewidth&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t295' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t296' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t297' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;coordinates&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;data&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t298' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>marked_line</span> <span class='op'>=</span> <span class='nam'>Scatter</span><span class='op'>(</span><span class='nam'>mode</span><span class='op'>=</span><span class='nam'>mode</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t299' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>name</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;label&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t300' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>=</span><span class='op'>[</span><span class='nam'>xy_pair</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>xy_pair</span> <span class='key'>in</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t301' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y</span><span class='op'>=</span><span class='op'>[</span><span class='nam'>xy_pair</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span> <span class='key'>for</span> <span class='nam'>xy_pair</span> <span class='key'>in</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t302' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span><span class='op'>=</span><span class='str'>&#39;x{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t303' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span><span class='op'>=</span><span class='str'>&#39;y{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t304' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>line</span><span class='op'>=</span><span class='nam'>line</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t305' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>marker</span><span class='op'>=</span><span class='nam'>marker</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t306' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span> <span class='op'>+=</span> <span class='nam'>marked_line</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t307' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Heck yeah, I drew that line\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t308' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t309' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Line didn&#39;t have &#39;data&#39; coordinates, &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
+<p id='t310' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;not drawing\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t311' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;Bummer! Plotly can currently only draw Line2D &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t312' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;objects from matplotlib that are in &#39;data&#39; &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t313' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;coordinates!&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t314' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t315' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_image</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t316' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Draw image.</span><span class='strut'>&nbsp;</span></p>
 <p id='t317' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t318' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t319' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw image\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t320' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Not drawing image\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t321' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;Aw. Snap! You&#39;re gonna have to hold off on &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t322' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;the selfies for now. Plotly can&#39;t import &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t323' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;images from matplotlib yet!&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t324' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t325' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_path_collection</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t326' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Add a path collection to data list as a scatter plot.</span><span class='strut'>&nbsp;</span></p>
-<p id='t327' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t328' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Current implementation defaults such collections as scatter plots.</span><span class='strut'>&nbsp;</span></p>
-<p id='t329' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Matplotlib supports collections that have many of the same parameters</span><span class='strut'>&nbsp;</span></p>
-<p id='t330' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; in common like color, size, path, etc. However, they needn&#39;t all be</span><span class='strut'>&nbsp;</span></p>
-<p id='t331' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; the same. Plotly does not currently support such functionality and</span><span class='strut'>&nbsp;</span></p>
-<p id='t332' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; therefore, the style for the first object is taken and used to define</span><span class='strut'>&nbsp;</span></p>
-<p id='t333' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; the remaining paths in the collection.</span><span class='strut'>&nbsp;</span></p>
-<p id='t334' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t335' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t336' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;paths&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (structure: [vertices, path_code])</span><span class='strut'>&nbsp;</span></p>
-<p id='t337' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;path_coordinates&#39;,&nbsp; &nbsp;&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, or &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t338' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;path_transforms&#39;,&nbsp; &nbsp; &nbsp; (mpl transform, including Affine2D matrix)</span><span class='strut'>&nbsp;</span></p>
-<p id='t339' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;offsets&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (offset from axes, helpful if in &#39;data&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t340' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;offset_coordinates&#39;,&nbsp;&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, or &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t341' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;offset_order&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t342' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;styles&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (style dict, see below)</span><span class='strut'>&nbsp;</span></p>
-<p id='t343' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (the collection obj being drawn)</span><span class='strut'>&nbsp;</span></p>
-<p id='t344' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t345' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t346' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;styles&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t347' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;linewidth&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (one or more linewidths)</span><span class='strut'>&nbsp;</span></p>
-<p id='t348' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;facecolor&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (one or more facecolors for path)</span><span class='strut'>&nbsp;</span></p>
-<p id='t349' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgecolor&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (one or more edgecolors for path)</span><span class='strut'>&nbsp;</span></p>
-<p id='t350' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (one or more opacites for path)</span><span class='strut'>&nbsp;</span></p>
-<p id='t351' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (precedence when stacked)</span><span class='strut'>&nbsp;</span></p>
-<p id='t352' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t353' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t354' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t355' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw a path collection\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t356' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;offset_coordinates&#39;</span><span class='op'>]</span> <span class='key'>is</span> <span class='str'>&#39;data&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t357' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>markerstyle</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_markerstyle_from_collection</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t358' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>scatter_props</span> <span class='op'>=</span> <span class='op'>{</span><span class='strut'>&nbsp;</span></p>
-<p id='t359' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;coordinates&#39;</span><span class='op'>:</span> <span class='str'>&#39;data&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t360' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;data&#39;</span><span class='op'>:</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;offsets&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t361' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;label&#39;</span><span class='op'>:</span> <span class='nam'>None</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t362' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;markerstyle&#39;</span><span class='op'>:</span> <span class='nam'>markerstyle</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t363' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;linestyle&#39;</span><span class='op'>:</span> <span class='nam'>None</span><span class='strut'>&nbsp;</span></p>
-<p id='t364' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>}</span><span class='strut'>&nbsp;</span></p>
-<p id='t365' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Drawing path collection as markers\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t366' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>draw_marked_line</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>scatter_props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t367' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t368' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Path collection not linked to &#39;data&#39;, &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
-<p id='t369' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;not drawing\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t370' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;Dang! That path collection is out of this &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t371' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;world. I totally don&#39;t know what to do with &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t372' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;it yet! Plotly can only import path &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t373' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;collections linked to &#39;data&#39; coordinates&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t374' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t375' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_path</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t376' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Draw path, currently only attempts to draw bar charts.</span><span class='strut'>&nbsp;</span></p>
-<p id='t377' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t378' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This function attempts to sort a given path into a collection of</span><span class='strut'>&nbsp;</span></p>
-<p id='t379' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; horizontal or vertical bar charts. Most of the actual code takes</span><span class='strut'>&nbsp;</span></p>
-<p id='t380' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; place in functions from mpltools.py.</span><span class='strut'>&nbsp;</span></p>
-<p id='t381' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t382' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t383' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;data&#39;,&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (a list of verticies for the path)</span><span class='strut'>&nbsp;</span></p>
-<p id='t384' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;coordinates&#39;,&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, or &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t385' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;pathcodes&#39;,&nbsp; &nbsp; (code for the path, structure: [&#39;M&#39;, &#39;L&#39;, &#39;Z&#39;, etc.])</span><span class='strut'>&nbsp;</span></p>
-<p id='t386' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;style&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (style dict, see below)</span><span class='strut'>&nbsp;</span></p>
-<p id='t387' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;&nbsp; &nbsp; &nbsp; &nbsp; (the mpl path object)</span><span class='strut'>&nbsp;</span></p>
-<p id='t388' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t389' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t390' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;style&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t391' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of path obj)</span><span class='strut'>&nbsp;</span></p>
-<p id='t392' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgecolor&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t393' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;facecolor&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t394' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgewidth&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t395' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;dasharray&#39;,&nbsp; &nbsp; (style for path&#39;s enclosing line)</span><span class='strut'>&nbsp;</span></p>
-<p id='t396' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;&nbsp; &nbsp; &nbsp; &nbsp; (precedence of obj when stacked)</span><span class='strut'>&nbsp;</span></p>
-<p id='t397' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t398' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t399' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t400' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw a path\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t401' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>is_bar</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>is_bar</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t402' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>is_barh</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>is_barh</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t403' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>is_bar</span><span class='op'>:</span>&nbsp; <span class='com'># if we think it&#39;s a bar, add it!</span><span class='strut'>&nbsp;</span></p>
-<p id='t404' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; Assuming path is a vertical bar\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t405' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>bar</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>make_bar</span><span class='op'>(</span><span class='nam'>orientation</span><span class='op'>=</span><span class='str'>&#39;v&#39;</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t406' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>file_bar</span><span class='op'>(</span><span class='nam'>bar</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t407' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>is_barh</span><span class='op'>:</span>&nbsp; <span class='com'># perhaps a horizontal bar?</span><span class='strut'>&nbsp;</span></p>
-<p id='t408' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; Assuming path is a horizontal bar\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t409' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>bar</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>make_bar</span><span class='op'>(</span><span class='nam'>orientation</span><span class='op'>=</span><span class='str'>&#39;h&#39;</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t410' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>file_bar</span><span class='op'>(</span><span class='nam'>bar</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t411' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='op'>(</span><span class='nam'>is_bar</span> <span class='key'>or</span> <span class='nam'>is_barh</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t412' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; This path isn&#39;t a bar, not drawing\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t413' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;I found a path object that I don&#39;t think is part &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t414' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;of a bar chart. Ignoring.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t415' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t416' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>file_bar</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>bar</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t417' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Puts a given bar into an appropriate bar or barh collection.</span><span class='strut'>&nbsp;</span></p>
-<p id='t418' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t419' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Bars come from the mplexporter one-by-one. To try to put them into</span><span class='strut'>&nbsp;</span></p>
-<p id='t420' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; appropriate data sets, we must compare them to existing data.</span><span class='strut'>&nbsp;</span></p>
-<p id='t421' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t422' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t423' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; bar -- a bar dictionary created in mpltools.make_bar.py.</span><span class='strut'>&nbsp;</span></p>
-<p id='t424' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t425' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; bar.keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t426' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;bar&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (mpl path object)</span><span class='strut'>&nbsp;</span></p>
-<p id='t427' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;orientation&#39;,&nbsp; (bar direction, &#39;v&#39; or &#39;h&#39; for horizontal or vertical)</span><span class='strut'>&nbsp;</span></p>
-<p id='t428' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;x0&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; ([x0, y0] = bottom-left corner of rectangle)</span><span class='strut'>&nbsp;</span></p>
-<p id='t429' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;y0&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t430' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;x1&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; ([x1, y1] = top-right corner of rectangle):</span><span class='strut'>&nbsp;</span></p>
-<p id='t431' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;y1&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t432' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of rectangle)</span><span class='strut'>&nbsp;</span></p>
-<p id='t433' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgecolor&#39;,&nbsp; &nbsp; (boundary line color)</span><span class='strut'>&nbsp;</span></p>
-<p id='t434' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;facecolor&#39;,&nbsp; &nbsp; (rectangle color)</span><span class='strut'>&nbsp;</span></p>
-<p id='t435' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgewidth&#39;,&nbsp; &nbsp; (boundary line width)</span><span class='strut'>&nbsp;</span></p>
-<p id='t436' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;dasharray&#39;,&nbsp; &nbsp; (linestyle for boundary line)</span><span class='strut'>&nbsp;</span></p>
-<p id='t437' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (precedence when stacked)</span><span class='strut'>&nbsp;</span></p>
-<p id='t438' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t439' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t440' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t441' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; Putting a bar into the proper bar collection\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t442' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t443' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Started a new bar collection with this &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
-<p id='t444' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;bar\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t445' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>.</span><span class='nam'>append</span><span class='op'>(</span><span class='op'>[</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t446' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>[</span><span class='op'>-</span><span class='num'>1</span><span class='op'>]</span> <span class='op'>+=</span> <span class='nam'>bar</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t447' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t448' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>match</span> <span class='op'>=</span> <span class='nam'>False</span><span class='strut'>&nbsp;</span></p>
-<p id='t449' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>patch_collection</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t450' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>check_bar_match</span><span class='op'>(</span><span class='nam'>patch_collection</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>bar</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t451' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>match</span> <span class='op'>=</span> <span class='nam'>True</span><span class='strut'>&nbsp;</span></p>
-<p id='t452' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>patch_collection</span> <span class='op'>+=</span> <span class='nam'>bar</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t453' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Filed bar into existing bar &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
-<p id='t454' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;collection\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t455' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>match</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t456' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Started a new bar collection with &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
-<p id='t457' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;this bar\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t458' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>.</span><span class='nam'>append</span><span class='op'>(</span><span class='op'>[</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t459' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>[</span><span class='op'>-</span><span class='num'>1</span><span class='op'>]</span> <span class='op'>+=</span> <span class='nam'>bar</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t460' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t461' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_text</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t462' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Create an annotation dict for a text obj.</span><span class='strut'>&nbsp;</span></p>
-<p id='t463' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t464' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Currently, plotly uses either &#39;page&#39; or &#39;data&#39; to reference</span><span class='strut'>&nbsp;</span></p>
-<p id='t465' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; annotation locations. These refer to &#39;display&#39; and &#39;data&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t466' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; respectively for the &#39;coordinates&#39; key used in the Exporter.</span><span class='strut'>&nbsp;</span></p>
-<p id='t467' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Appropriate measures are taken to transform text locations to</span><span class='strut'>&nbsp;</span></p>
-<p id='t468' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; reference one of these two options.</span><span class='strut'>&nbsp;</span></p>
-<p id='t469' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t470' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t471' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text&#39;,&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (actual content string, not the text obj)</span><span class='strut'>&nbsp;</span></p>
-<p id='t472' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;position&#39;,&nbsp; &nbsp;&nbsp; (an x, y pair, not an mpl Bbox)</span><span class='strut'>&nbsp;</span></p>
-<p id='t473' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;coordinates&#39;,&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t474' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text_type&#39;,&nbsp; &nbsp; (&#39;title&#39;, &#39;xlabel&#39;, or &#39;ylabel&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t475' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;style&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (style dict, see below)</span><span class='strut'>&nbsp;</span></p>
-<p id='t476' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;&nbsp; &nbsp; &nbsp; &nbsp; (actual mpl text object)</span><span class='strut'>&nbsp;</span></p>
-<p id='t477' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t478' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t479' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;style&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t480' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of text)</span><span class='strut'>&nbsp;</span></p>
-<p id='t481' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;fontsize&#39;,&nbsp; &nbsp;&nbsp; (size in points of text)</span><span class='strut'>&nbsp;</span></p>
-<p id='t482' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;color&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (hex color)</span><span class='strut'>&nbsp;</span></p>
-<p id='t483' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;halign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (horizontal alignment, &#39;left&#39;, &#39;center&#39;, or &#39;right&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t484' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;valign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (vertical alignment, &#39;baseline&#39;, &#39;center&#39;, or &#39;top&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t485' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;rotation&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t486' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (precedence of text when stacked with other objs)</span><span class='strut'>&nbsp;</span></p>
-<p id='t487' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t488' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t489' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t490' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw an mpl text object\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t491' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>check_corners</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;mplobj&#39;</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_fig</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t492' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;Looks like the annotation(s) you are trying \n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t493' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;to draw lies/lay outside the given figure size.\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t494' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Therefore, the resulting Plotly figure may not be \n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t495' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;large enough to view the full text. To adjust \n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t496' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;the size of the figure, use the &#39;width&#39; and \n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t497' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;height&#39; keys in the Layout object. Alternatively,\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t498' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;use the Margin object to adjust the figure&#39;s margins.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t499' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>align</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;mplobj&#39;</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>_multialignment</span><span class='strut'>&nbsp;</span></p>
-<p id='t500' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>align</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t501' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>align</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;halign&#39;</span><span class='op'>]</span> <span class='com'># mpl default</span><span class='strut'>&nbsp;</span></p>
-<p id='t502' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;annotations&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t503' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;annotations&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>Annotations</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t504' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text_type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;xlabel&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t505' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; Text object is an xlabel\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t506' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>draw_xlabel</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t507' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text_type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;ylabel&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t508' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; Text object is a ylabel\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t509' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>draw_ylabel</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t510' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text_type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;title&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t511' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; Text object is a title\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t512' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>draw_title</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t513' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span>&nbsp; <span class='com'># just a regular text annotation...</span><span class='strut'>&nbsp;</span></p>
-<p id='t514' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; Text object is a normal annotation\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t515' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;coordinates&#39;</span><span class='op'>]</span> <span class='key'>is</span> <span class='key'>not</span> <span class='str'>&#39;data&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t516' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; Text object isn&#39;t linked to &#39;data&#39; &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
-<p id='t517' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;coordinates\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t518' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x_px</span><span class='op'>,</span> <span class='nam'>y_px</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;mplobj&#39;</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>get_transform</span><span class='op'>(</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>transform</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t519' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;position&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t520' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>,</span> <span class='nam'>y</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>display_to_paper</span><span class='op'>(</span><span class='nam'>x_px</span><span class='op'>,</span> <span class='nam'>y_px</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t521' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t522' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xref</span> <span class='op'>=</span> <span class='str'>&#39;paper&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t523' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yref</span> <span class='op'>=</span> <span class='str'>&#39;paper&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t524' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xanchor</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;halign&#39;</span><span class='op'>]</span>&nbsp; <span class='com'># no difference here!</span><span class='strut'>&nbsp;</span></p>
-<p id='t525' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yanchor</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>convert_va</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;valign&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t526' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t527' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; Text object is linked to &#39;data&#39; &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
-<p id='t528' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;coordinates\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t529' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>,</span> <span class='nam'>y</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;position&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t530' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>axis_ct</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='strut'>&nbsp;</span></p>
-<p id='t531' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;xaxis{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t532' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;yaxis{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t533' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='nam'>xaxis</span><span class='op'>[</span><span class='str'>&#39;range&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span> <span class='op'>&lt;</span> <span class='nam'>x</span> <span class='op'>&lt;</span> <span class='nam'>xaxis</span><span class='op'>[</span><span class='str'>&#39;range&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t534' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>and</span> <span class='nam'>yaxis</span><span class='op'>[</span><span class='str'>&#39;range&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span> <span class='op'>&lt;</span> <span class='nam'>y</span> <span class='op'>&lt;</span> <span class='nam'>yaxis</span><span class='op'>[</span><span class='str'>&#39;range&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t535' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xref</span> <span class='op'>=</span> <span class='str'>&#39;x{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t536' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yref</span> <span class='op'>=</span> <span class='str'>&#39;y{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t537' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t538' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Text object is outside &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
-<p id='t539' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;plotting area, making &#39;paper&#39; reference.\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t540' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x_px</span><span class='op'>,</span> <span class='nam'>y_px</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;mplobj&#39;</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>get_transform</span><span class='op'>(</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>transform</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t541' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;position&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t542' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>,</span> <span class='nam'>y</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>display_to_paper</span><span class='op'>(</span><span class='nam'>x_px</span><span class='op'>,</span> <span class='nam'>y_px</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t543' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t544' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xref</span> <span class='op'>=</span> <span class='str'>&#39;paper&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t545' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yref</span> <span class='op'>=</span> <span class='str'>&#39;paper&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t546' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xanchor</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;halign&#39;</span><span class='op'>]</span>&nbsp; <span class='com'># no difference here!</span><span class='strut'>&nbsp;</span></p>
-<p id='t547' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yanchor</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>convert_va</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;valign&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t548' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>annotation</span> <span class='op'>=</span> <span class='nam'>Annotation</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t549' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>text</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t550' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>opacity</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;alpha&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t551' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>=</span><span class='nam'>x</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t552' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y</span><span class='op'>=</span><span class='nam'>y</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t553' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xref</span><span class='op'>=</span><span class='nam'>xref</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t554' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yref</span><span class='op'>=</span><span class='nam'>yref</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t555' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>align</span><span class='op'>=</span><span class='nam'>align</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t556' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xanchor</span><span class='op'>=</span><span class='nam'>xanchor</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t557' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yanchor</span><span class='op'>=</span><span class='nam'>yanchor</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t558' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>showarrow</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span>&nbsp; <span class='com'># change this later?</span><span class='strut'>&nbsp;</span></p>
-<p id='t559' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>font</span><span class='op'>=</span><span class='nam'>Font</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t560' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;color&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t561' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>size</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;fontsize&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t562' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t563' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t564' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;annotations&#39;</span><span class='op'>]</span> <span class='op'>+=</span> <span class='nam'>annotation</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t565' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Heck, yeah I drew that annotation\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t566' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t567' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_title</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t568' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Add a title to the current subplot in layout dictionary.</span><span class='strut'>&nbsp;</span></p>
-<p id='t569' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t570' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; If there exists more than a single plot in the figure, titles revert</span><span class='strut'>&nbsp;</span></p>
-<p id='t571' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; to &#39;page&#39;-referenced annotations.</span><span class='strut'>&nbsp;</span></p>
-<p id='t572' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t573' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t574' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text&#39;,&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (actual content string, not the text obj)</span><span class='strut'>&nbsp;</span></p>
-<p id='t575' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;position&#39;,&nbsp; &nbsp;&nbsp; (an x, y pair, not an mpl Bbox)</span><span class='strut'>&nbsp;</span></p>
-<p id='t576' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;coordinates&#39;,&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t577' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text_type&#39;,&nbsp; &nbsp; (&#39;title&#39;, &#39;xlabel&#39;, or &#39;ylabel&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t578' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;style&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (style dict, see below)</span><span class='strut'>&nbsp;</span></p>
-<p id='t579' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;&nbsp; &nbsp; &nbsp; &nbsp; (actual mpl text object)</span><span class='strut'>&nbsp;</span></p>
-<p id='t580' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t581' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t582' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;style&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t583' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of text)</span><span class='strut'>&nbsp;</span></p>
-<p id='t584' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;fontsize&#39;,&nbsp; &nbsp;&nbsp; (size in points of text)</span><span class='strut'>&nbsp;</span></p>
-<p id='t585' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;color&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (hex color)</span><span class='strut'>&nbsp;</span></p>
-<p id='t586' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;halign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (horizontal alignment, &#39;left&#39;, &#39;center&#39;, or &#39;right&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t587' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;valign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (vertical alignment, &#39;baseline&#39;, &#39;center&#39;, or &#39;top&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t588' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;rotation&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t589' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (precedence of text when stacked with other objs)</span><span class='strut'>&nbsp;</span></p>
-<p id='t590' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t591' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t592' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t593' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; Attempting to draw a title\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t594' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_fig</span><span class='op'>.</span><span class='nam'>axes</span><span class='op'>)</span> <span class='op'>&gt;</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t595' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; More than one subplot, adding title as &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
-<p id='t596' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;annotation\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t597' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x_px</span><span class='op'>,</span> <span class='nam'>y_px</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;mplobj&#39;</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>get_transform</span><span class='op'>(</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>transform</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='strut'>&nbsp;</span></p>
-<p id='t598' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;position&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t599' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>,</span> <span class='nam'>y</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>display_to_paper</span><span class='op'>(</span><span class='nam'>x_px</span><span class='op'>,</span> <span class='nam'>y_px</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t600' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t601' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>annotation</span> <span class='op'>=</span> <span class='nam'>Annotation</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t602' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>text</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t603' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>font</span><span class='op'>=</span><span class='nam'>Font</span><span class='op'>(</span><span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;color&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t604' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>size</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;fontsize&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t605' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t606' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xref</span><span class='op'>=</span><span class='str'>&#39;paper&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t607' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yref</span><span class='op'>=</span><span class='str'>&#39;paper&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t608' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>=</span><span class='nam'>x</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t609' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y</span><span class='op'>=</span><span class='nam'>y</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t610' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xanchor</span><span class='op'>=</span><span class='str'>&#39;center&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t611' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yanchor</span><span class='op'>=</span><span class='str'>&#39;bottom&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t612' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>showarrow</span><span class='op'>=</span><span class='nam'>False</span>&nbsp; <span class='com'># no arrow for a title!</span><span class='strut'>&nbsp;</span></p>
-<p id='t613' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t614' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;annotations&#39;</span><span class='op'>]</span> <span class='op'>+=</span> <span class='nam'>annotation</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t615' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t616' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Only one subplot found, adding as a &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
-<p id='t617' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;plotly title\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t618' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;title&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t619' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>titlefont</span> <span class='op'>=</span> <span class='nam'>Font</span><span class='op'>(</span><span class='nam'>size</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;fontsize&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t620' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;color&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t621' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t622' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;titlefont&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>titlefont</span><span class='strut'>&nbsp;</span></p>
-<p id='t623' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t624' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_xlabel</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t625' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Add an xaxis label to the current subplot in layout dictionary.</span><span class='strut'>&nbsp;</span></p>
-<p id='t626' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t627' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t628' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text&#39;,&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (actual content string, not the text obj)</span><span class='strut'>&nbsp;</span></p>
-<p id='t629' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;position&#39;,&nbsp; &nbsp;&nbsp; (an x, y pair, not an mpl Bbox)</span><span class='strut'>&nbsp;</span></p>
-<p id='t630' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;coordinates&#39;,&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t631' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text_type&#39;,&nbsp; &nbsp; (&#39;title&#39;, &#39;xlabel&#39;, or &#39;ylabel&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t632' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;style&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (style dict, see below)</span><span class='strut'>&nbsp;</span></p>
-<p id='t633' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;&nbsp; &nbsp; &nbsp; &nbsp; (actual mpl text object)</span><span class='strut'>&nbsp;</span></p>
-<p id='t634' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t635' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t636' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;style&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t637' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of text)</span><span class='strut'>&nbsp;</span></p>
-<p id='t638' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;fontsize&#39;,&nbsp; &nbsp;&nbsp; (size in points of text)</span><span class='strut'>&nbsp;</span></p>
-<p id='t639' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;color&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (hex color)</span><span class='strut'>&nbsp;</span></p>
-<p id='t640' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;halign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (horizontal alignment, &#39;left&#39;, &#39;center&#39;, or &#39;right&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t641' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;valign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (vertical alignment, &#39;baseline&#39;, &#39;center&#39;, or &#39;top&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t642' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;rotation&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t643' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (precedence of text when stacked with other objs)</span><span class='strut'>&nbsp;</span></p>
-<p id='t644' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t645' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t646' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t647' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; Adding xlabel\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t648' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>axis_key</span> <span class='op'>=</span> <span class='str'>&#39;xaxis{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t649' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>axis_key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;title&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t650' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>titlefont</span> <span class='op'>=</span> <span class='nam'>Font</span><span class='op'>(</span><span class='nam'>size</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;fontsize&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t651' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;color&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t652' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>axis_key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;titlefont&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>titlefont</span><span class='strut'>&nbsp;</span></p>
-<p id='t653' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t654' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_ylabel</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t655' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Add a yaxis label to the current subplot in layout dictionary.</span><span class='strut'>&nbsp;</span></p>
-<p id='t656' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t657' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t658' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text&#39;,&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (actual content string, not the text obj)</span><span class='strut'>&nbsp;</span></p>
-<p id='t659' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;position&#39;,&nbsp; &nbsp;&nbsp; (an x, y pair, not an mpl Bbox)</span><span class='strut'>&nbsp;</span></p>
-<p id='t660' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;coordinates&#39;,&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t661' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text_type&#39;,&nbsp; &nbsp; (&#39;title&#39;, &#39;xlabel&#39;, or &#39;ylabel&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t662' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;style&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (style dict, see below)</span><span class='strut'>&nbsp;</span></p>
-<p id='t663' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;&nbsp; &nbsp; &nbsp; &nbsp; (actual mpl text object)</span><span class='strut'>&nbsp;</span></p>
-<p id='t664' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t665' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t666' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;style&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
-<p id='t667' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of text)</span><span class='strut'>&nbsp;</span></p>
-<p id='t668' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;fontsize&#39;,&nbsp; &nbsp;&nbsp; (size in points of text)</span><span class='strut'>&nbsp;</span></p>
-<p id='t669' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;color&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (hex color)</span><span class='strut'>&nbsp;</span></p>
-<p id='t670' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;halign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (horizontal alignment, &#39;left&#39;, &#39;center&#39;, or &#39;right&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t671' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;valign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (vertical alignment, &#39;baseline&#39;, &#39;center&#39;, or &#39;top&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t672' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;rotation&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t673' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (precedence of text when stacked with other objs)</span><span class='strut'>&nbsp;</span></p>
-<p id='t674' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
-<p id='t675' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t676' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t677' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; Adding ylabel\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t678' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>axis_key</span> <span class='op'>=</span> <span class='str'>&#39;yaxis{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t679' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>axis_key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;title&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t680' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>titlefont</span> <span class='op'>=</span> <span class='nam'>Font</span><span class='op'>(</span><span class='nam'>size</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;fontsize&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t681' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;color&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t682' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>axis_key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;titlefont&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>titlefont</span><span class='strut'>&nbsp;</span></p>
-<p id='t683' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t684' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>resize</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t685' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Revert figure layout to allow plotly to resize.</span><span class='strut'>&nbsp;</span></p>
-<p id='t686' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t687' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; By default, PlotlyRenderer tries its hardest to precisely mimic an</span><span class='strut'>&nbsp;</span></p>
-<p id='t688' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; mpl figure. However, plotly is pretty good with aesthetics. By</span><span class='strut'>&nbsp;</span></p>
-<p id='t689' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; running PlotlyRenderer.resize(), layout parameters are deleted. This</span><span class='strut'>&nbsp;</span></p>
-<p id='t690' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; lets plotly choose them instead of mpl.</span><span class='strut'>&nbsp;</span></p>
-<p id='t691' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t692' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t693' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;Resizing figure, deleting keys from layout\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t694' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='op'>[</span><span class='str'>&#39;width&#39;</span><span class='op'>,</span> <span class='str'>&#39;height&#39;</span><span class='op'>,</span> <span class='str'>&#39;autosize&#39;</span><span class='op'>,</span> <span class='str'>&#39;margin&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t695' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t696' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t697' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t698' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t699' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t700' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>strip_style</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t701' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;Stripping mpl style, deleting keys from data and layout\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t702' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>.</span><span class='nam'>strip_style</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t318' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Not implemented yet!</span><span class='strut'>&nbsp;</span></p>
+<p id='t319' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t320' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t321' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw image\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t322' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Not drawing image\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t323' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;Aw. Snap! You&#39;re gonna have to hold off on &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t324' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;the selfies for now. Plotly can&#39;t import &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t325' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;images from matplotlib yet!&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t326' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t327' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_path_collection</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t328' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Add a path collection to data list as a scatter plot.</span><span class='strut'>&nbsp;</span></p>
+<p id='t329' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t330' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Current implementation defaults such collections as scatter plots.</span><span class='strut'>&nbsp;</span></p>
+<p id='t331' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Matplotlib supports collections that have many of the same parameters</span><span class='strut'>&nbsp;</span></p>
+<p id='t332' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; in common like color, size, path, etc. However, they needn&#39;t all be</span><span class='strut'>&nbsp;</span></p>
+<p id='t333' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; the same. Plotly does not currently support such functionality and</span><span class='strut'>&nbsp;</span></p>
+<p id='t334' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; therefore, the style for the first object is taken and used to define</span><span class='strut'>&nbsp;</span></p>
+<p id='t335' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; the remaining paths in the collection.</span><span class='strut'>&nbsp;</span></p>
+<p id='t336' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t337' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t338' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;paths&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (structure: [vertices, path_code])</span><span class='strut'>&nbsp;</span></p>
+<p id='t339' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;path_coordinates&#39;,&nbsp; &nbsp;&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, or &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t340' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;path_transforms&#39;,&nbsp; &nbsp; &nbsp; (mpl transform, including Affine2D matrix)</span><span class='strut'>&nbsp;</span></p>
+<p id='t341' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;offsets&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (offset from axes, helpful if in &#39;data&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t342' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;offset_coordinates&#39;,&nbsp;&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, or &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t343' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;offset_order&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t344' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;styles&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (style dict, see below)</span><span class='strut'>&nbsp;</span></p>
+<p id='t345' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (the collection obj being drawn)</span><span class='strut'>&nbsp;</span></p>
+<p id='t346' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t347' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t348' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;styles&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t349' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;linewidth&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (one or more linewidths)</span><span class='strut'>&nbsp;</span></p>
+<p id='t350' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;facecolor&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (one or more facecolors for path)</span><span class='strut'>&nbsp;</span></p>
+<p id='t351' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgecolor&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (one or more edgecolors for path)</span><span class='strut'>&nbsp;</span></p>
+<p id='t352' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (one or more opacites for path)</span><span class='strut'>&nbsp;</span></p>
+<p id='t353' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (precedence when stacked)</span><span class='strut'>&nbsp;</span></p>
+<p id='t354' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t355' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t356' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t357' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw a path collection\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t358' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;offset_coordinates&#39;</span><span class='op'>]</span> <span class='key'>is</span> <span class='str'>&#39;data&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t359' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>markerstyle</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>get_markerstyle_from_collection</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t360' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>scatter_props</span> <span class='op'>=</span> <span class='op'>{</span><span class='strut'>&nbsp;</span></p>
+<p id='t361' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;coordinates&#39;</span><span class='op'>:</span> <span class='str'>&#39;data&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t362' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;data&#39;</span><span class='op'>:</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;offsets&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t363' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;label&#39;</span><span class='op'>:</span> <span class='nam'>None</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t364' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;markerstyle&#39;</span><span class='op'>:</span> <span class='nam'>markerstyle</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t365' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;linestyle&#39;</span><span class='op'>:</span> <span class='nam'>None</span><span class='strut'>&nbsp;</span></p>
+<p id='t366' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>}</span><span class='strut'>&nbsp;</span></p>
+<p id='t367' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Drawing path collection as markers\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t368' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>draw_marked_line</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>scatter_props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t369' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t370' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Path collection not linked to &#39;data&#39;, &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
+<p id='t371' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;not drawing\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t372' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;Dang! That path collection is out of this &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t373' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;world. I totally don&#39;t know what to do with &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t374' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;it yet! Plotly can only import path &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t375' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;collections linked to &#39;data&#39; coordinates&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t376' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t377' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_path</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t378' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Draw path, currently only attempts to draw bar charts.</span><span class='strut'>&nbsp;</span></p>
+<p id='t379' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t380' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; This function attempts to sort a given path into a collection of</span><span class='strut'>&nbsp;</span></p>
+<p id='t381' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; horizontal or vertical bar charts. Most of the actual code takes</span><span class='strut'>&nbsp;</span></p>
+<p id='t382' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; place in functions from mpltools.py.</span><span class='strut'>&nbsp;</span></p>
+<p id='t383' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t384' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t385' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;data&#39;,&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (a list of verticies for the path)</span><span class='strut'>&nbsp;</span></p>
+<p id='t386' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;coordinates&#39;,&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, or &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t387' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;pathcodes&#39;,&nbsp; &nbsp; (code for the path, structure: [&#39;M&#39;, &#39;L&#39;, &#39;Z&#39;, etc.])</span><span class='strut'>&nbsp;</span></p>
+<p id='t388' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;style&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (style dict, see below)</span><span class='strut'>&nbsp;</span></p>
+<p id='t389' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;&nbsp; &nbsp; &nbsp; &nbsp; (the mpl path object)</span><span class='strut'>&nbsp;</span></p>
+<p id='t390' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t391' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t392' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;style&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t393' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of path obj)</span><span class='strut'>&nbsp;</span></p>
+<p id='t394' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgecolor&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t395' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;facecolor&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t396' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgewidth&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t397' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;dasharray&#39;,&nbsp; &nbsp; (style for path&#39;s enclosing line)</span><span class='strut'>&nbsp;</span></p>
+<p id='t398' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;&nbsp; &nbsp; &nbsp; &nbsp; (precedence of obj when stacked)</span><span class='strut'>&nbsp;</span></p>
+<p id='t399' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t400' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t401' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t402' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw a path\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t403' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>is_bar</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>is_bar</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t404' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>is_barh</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>is_barh</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t405' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>is_bar</span><span class='op'>:</span>&nbsp; <span class='com'># if we think it&#39;s a bar, add it!</span><span class='strut'>&nbsp;</span></p>
+<p id='t406' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; Assuming path is a vertical bar\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t407' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>bar</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>make_bar</span><span class='op'>(</span><span class='nam'>orientation</span><span class='op'>=</span><span class='str'>&#39;v&#39;</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t408' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>file_bar</span><span class='op'>(</span><span class='nam'>bar</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t409' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>is_barh</span><span class='op'>:</span>&nbsp; <span class='com'># perhaps a horizontal bar?</span><span class='strut'>&nbsp;</span></p>
+<p id='t410' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; Assuming path is a horizontal bar\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t411' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>bar</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>make_bar</span><span class='op'>(</span><span class='nam'>orientation</span><span class='op'>=</span><span class='str'>&#39;h&#39;</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t412' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>file_bar</span><span class='op'>(</span><span class='nam'>bar</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t413' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='op'>(</span><span class='nam'>is_bar</span> <span class='key'>or</span> <span class='nam'>is_barh</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t414' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; This path isn&#39;t a bar, not drawing\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t415' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;I found a path object that I don&#39;t think is part &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t416' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;of a bar chart. Ignoring.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t417' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t418' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>file_bar</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>bar</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t419' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Puts a given bar into an appropriate bar or barh collection.</span><span class='strut'>&nbsp;</span></p>
+<p id='t420' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t421' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Bars come from the mplexporter one-by-one. To try to put them into</span><span class='strut'>&nbsp;</span></p>
+<p id='t422' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; appropriate data sets, we must compare them to existing data.</span><span class='strut'>&nbsp;</span></p>
+<p id='t423' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t424' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t425' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; bar -- a bar dictionary created in mpltools.make_bar.py.</span><span class='strut'>&nbsp;</span></p>
+<p id='t426' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t427' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; bar.keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t428' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;bar&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (mpl path object)</span><span class='strut'>&nbsp;</span></p>
+<p id='t429' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;orientation&#39;,&nbsp; (bar direction, &#39;v&#39; or &#39;h&#39; for horizontal or vertical)</span><span class='strut'>&nbsp;</span></p>
+<p id='t430' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;x0&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; ([x0, y0] = bottom-left corner of rectangle)</span><span class='strut'>&nbsp;</span></p>
+<p id='t431' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;y0&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t432' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;x1&#39;,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; ([x1, y1] = top-right corner of rectangle):</span><span class='strut'>&nbsp;</span></p>
+<p id='t433' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;y1&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t434' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of rectangle)</span><span class='strut'>&nbsp;</span></p>
+<p id='t435' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgecolor&#39;,&nbsp; &nbsp; (boundary line color)</span><span class='strut'>&nbsp;</span></p>
+<p id='t436' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;facecolor&#39;,&nbsp; &nbsp; (rectangle color)</span><span class='strut'>&nbsp;</span></p>
+<p id='t437' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;edgewidth&#39;,&nbsp; &nbsp; (boundary line width)</span><span class='strut'>&nbsp;</span></p>
+<p id='t438' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;dasharray&#39;,&nbsp; &nbsp; (linestyle for boundary line)</span><span class='strut'>&nbsp;</span></p>
+<p id='t439' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (precedence when stacked)</span><span class='strut'>&nbsp;</span></p>
+<p id='t440' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t441' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t442' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t443' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; Putting a bar into the proper bar collection\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t444' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>)</span> <span class='op'>==</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t445' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Started a new bar collection with this &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
+<p id='t446' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;bar\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t447' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>.</span><span class='nam'>append</span><span class='op'>(</span><span class='op'>[</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t448' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>[</span><span class='op'>-</span><span class='num'>1</span><span class='op'>]</span> <span class='op'>+=</span> <span class='nam'>bar</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t449' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t450' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>match</span> <span class='op'>=</span> <span class='nam'>False</span><span class='strut'>&nbsp;</span></p>
+<p id='t451' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>patch_collection</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t452' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>check_bar_match</span><span class='op'>(</span><span class='nam'>patch_collection</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>bar</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t453' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>match</span> <span class='op'>=</span> <span class='nam'>True</span><span class='strut'>&nbsp;</span></p>
+<p id='t454' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>patch_collection</span> <span class='op'>+=</span> <span class='nam'>bar</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t455' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Filed bar into existing bar &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
+<p id='t456' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;collection\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t457' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>match</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t458' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Started a new bar collection with &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
+<p id='t459' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;this bar\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t460' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>.</span><span class='nam'>append</span><span class='op'>(</span><span class='op'>[</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t461' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>current_ax_patches</span><span class='op'>[</span><span class='op'>-</span><span class='num'>1</span><span class='op'>]</span> <span class='op'>+=</span> <span class='nam'>bar</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t462' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t463' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_text</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t464' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Create an annotation dict for a text obj.</span><span class='strut'>&nbsp;</span></p>
+<p id='t465' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t466' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Currently, plotly uses either &#39;page&#39; or &#39;data&#39; to reference</span><span class='strut'>&nbsp;</span></p>
+<p id='t467' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; annotation locations. These refer to &#39;display&#39; and &#39;data&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t468' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; respectively for the &#39;coordinates&#39; key used in the Exporter.</span><span class='strut'>&nbsp;</span></p>
+<p id='t469' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Appropriate measures are taken to transform text locations to</span><span class='strut'>&nbsp;</span></p>
+<p id='t470' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; reference one of these two options.</span><span class='strut'>&nbsp;</span></p>
+<p id='t471' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t472' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t473' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text&#39;,&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (actual content string, not the text obj)</span><span class='strut'>&nbsp;</span></p>
+<p id='t474' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;position&#39;,&nbsp; &nbsp;&nbsp; (an x, y pair, not an mpl Bbox)</span><span class='strut'>&nbsp;</span></p>
+<p id='t475' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;coordinates&#39;,&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t476' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text_type&#39;,&nbsp; &nbsp; (&#39;title&#39;, &#39;xlabel&#39;, or &#39;ylabel&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t477' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;style&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (style dict, see below)</span><span class='strut'>&nbsp;</span></p>
+<p id='t478' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;&nbsp; &nbsp; &nbsp; &nbsp; (actual mpl text object)</span><span class='strut'>&nbsp;</span></p>
+<p id='t479' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t480' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t481' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;style&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t482' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of text)</span><span class='strut'>&nbsp;</span></p>
+<p id='t483' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;fontsize&#39;,&nbsp; &nbsp;&nbsp; (size in points of text)</span><span class='strut'>&nbsp;</span></p>
+<p id='t484' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;color&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (hex color)</span><span class='strut'>&nbsp;</span></p>
+<p id='t485' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;halign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (horizontal alignment, &#39;left&#39;, &#39;center&#39;, or &#39;right&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t486' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;valign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (vertical alignment, &#39;baseline&#39;, &#39;center&#39;, or &#39;top&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t487' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;rotation&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t488' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (precedence of text when stacked with other objs)</span><span class='strut'>&nbsp;</span></p>
+<p id='t489' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t490' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t491' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t492' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Attempting to draw an mpl text object\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t493' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>check_corners</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;mplobj&#39;</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_fig</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t494' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;Looks like the annotation(s) you are trying \n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t495' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;to draw lies/lay outside the given figure size.\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t496' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Therefore, the resulting Plotly figure may not be \n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t497' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;large enough to view the full text. To adjust \n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t498' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;the size of the figure, use the &#39;width&#39; and \n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t499' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;height&#39; keys in the Layout object. Alternatively,\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t500' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;use the Margin object to adjust the figure&#39;s margins.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t501' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>align</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;mplobj&#39;</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>_multialignment</span><span class='strut'>&nbsp;</span></p>
+<p id='t502' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>align</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t503' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>align</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;halign&#39;</span><span class='op'>]</span> <span class='com'># mpl default</span><span class='strut'>&nbsp;</span></p>
+<p id='t504' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;annotations&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t505' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;annotations&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>Annotations</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t506' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text_type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;xlabel&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t507' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; Text object is an xlabel\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t508' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>draw_xlabel</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t509' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text_type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;ylabel&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t510' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; Text object is a ylabel\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t511' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>draw_ylabel</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t512' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text_type&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;title&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t513' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; Text object is a title\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t514' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>draw_title</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t515' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span>&nbsp; <span class='com'># just a regular text annotation...</span><span class='strut'>&nbsp;</span></p>
+<p id='t516' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; Text object is a normal annotation\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t517' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;coordinates&#39;</span><span class='op'>]</span> <span class='key'>is</span> <span class='key'>not</span> <span class='str'>&#39;data&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t518' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; Text object isn&#39;t linked to &#39;data&#39; &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
+<p id='t519' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;coordinates\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t520' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x_px</span><span class='op'>,</span> <span class='nam'>y_px</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;mplobj&#39;</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>get_transform</span><span class='op'>(</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>transform</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t521' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;position&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t522' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>,</span> <span class='nam'>y</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>display_to_paper</span><span class='op'>(</span><span class='nam'>x_px</span><span class='op'>,</span> <span class='nam'>y_px</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t523' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t524' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xref</span> <span class='op'>=</span> <span class='str'>&#39;paper&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t525' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yref</span> <span class='op'>=</span> <span class='str'>&#39;paper&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t526' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xanchor</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;halign&#39;</span><span class='op'>]</span>&nbsp; <span class='com'># no difference here!</span><span class='strut'>&nbsp;</span></p>
+<p id='t527' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yanchor</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>convert_va</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;valign&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t528' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t529' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; Text object is linked to &#39;data&#39; &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
+<p id='t530' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;coordinates\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t531' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>,</span> <span class='nam'>y</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;position&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t532' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>axis_ct</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='strut'>&nbsp;</span></p>
+<p id='t533' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;xaxis{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t534' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span> <span class='op'>=</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;yaxis{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t535' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='nam'>xaxis</span><span class='op'>[</span><span class='str'>&#39;range&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span> <span class='op'>&lt;</span> <span class='nam'>x</span> <span class='op'>&lt;</span> <span class='nam'>xaxis</span><span class='op'>[</span><span class='str'>&#39;range&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t536' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>and</span> <span class='nam'>yaxis</span><span class='op'>[</span><span class='str'>&#39;range&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span> <span class='op'>&lt;</span> <span class='nam'>y</span> <span class='op'>&lt;</span> <span class='nam'>yaxis</span><span class='op'>[</span><span class='str'>&#39;range&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t537' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xref</span> <span class='op'>=</span> <span class='str'>&#39;x{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t538' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yref</span> <span class='op'>=</span> <span class='str'>&#39;y{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t539' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t540' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Text object is outside &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
+<p id='t541' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;plotting area, making &#39;paper&#39; reference.\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t542' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x_px</span><span class='op'>,</span> <span class='nam'>y_px</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;mplobj&#39;</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>get_transform</span><span class='op'>(</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>transform</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t543' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;position&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t544' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>,</span> <span class='nam'>y</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>display_to_paper</span><span class='op'>(</span><span class='nam'>x_px</span><span class='op'>,</span> <span class='nam'>y_px</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t545' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t546' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xref</span> <span class='op'>=</span> <span class='str'>&#39;paper&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t547' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yref</span> <span class='op'>=</span> <span class='str'>&#39;paper&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t548' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xanchor</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;halign&#39;</span><span class='op'>]</span>&nbsp; <span class='com'># no difference here!</span><span class='strut'>&nbsp;</span></p>
+<p id='t549' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yanchor</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>convert_va</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;valign&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t550' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>annotation</span> <span class='op'>=</span> <span class='nam'>Annotation</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t551' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>text</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t552' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>opacity</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;alpha&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t553' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>=</span><span class='nam'>x</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t554' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y</span><span class='op'>=</span><span class='nam'>y</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t555' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xref</span><span class='op'>=</span><span class='nam'>xref</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t556' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yref</span><span class='op'>=</span><span class='nam'>yref</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t557' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>align</span><span class='op'>=</span><span class='nam'>align</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t558' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xanchor</span><span class='op'>=</span><span class='nam'>xanchor</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t559' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yanchor</span><span class='op'>=</span><span class='nam'>yanchor</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t560' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>showarrow</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span>&nbsp; <span class='com'># change this later?</span><span class='strut'>&nbsp;</span></p>
+<p id='t561' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>font</span><span class='op'>=</span><span class='nam'>Font</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t562' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;color&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t563' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>size</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;fontsize&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t564' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t565' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t566' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;annotations&#39;</span><span class='op'>]</span> <span class='op'>+=</span> <span class='nam'>annotation</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t567' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; Heck, yeah I drew that annotation\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t568' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t569' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_title</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t570' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Add a title to the current subplot in layout dictionary.</span><span class='strut'>&nbsp;</span></p>
+<p id='t571' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t572' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; If there exists more than a single plot in the figure, titles revert</span><span class='strut'>&nbsp;</span></p>
+<p id='t573' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; to &#39;page&#39;-referenced annotations.</span><span class='strut'>&nbsp;</span></p>
+<p id='t574' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t575' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t576' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text&#39;,&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (actual content string, not the text obj)</span><span class='strut'>&nbsp;</span></p>
+<p id='t577' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;position&#39;,&nbsp; &nbsp;&nbsp; (an x, y pair, not an mpl Bbox)</span><span class='strut'>&nbsp;</span></p>
+<p id='t578' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;coordinates&#39;,&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t579' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text_type&#39;,&nbsp; &nbsp; (&#39;title&#39;, &#39;xlabel&#39;, or &#39;ylabel&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t580' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;style&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (style dict, see below)</span><span class='strut'>&nbsp;</span></p>
+<p id='t581' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;&nbsp; &nbsp; &nbsp; &nbsp; (actual mpl text object)</span><span class='strut'>&nbsp;</span></p>
+<p id='t582' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t583' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t584' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;style&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t585' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of text)</span><span class='strut'>&nbsp;</span></p>
+<p id='t586' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;fontsize&#39;,&nbsp; &nbsp;&nbsp; (size in points of text)</span><span class='strut'>&nbsp;</span></p>
+<p id='t587' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;color&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (hex color)</span><span class='strut'>&nbsp;</span></p>
+<p id='t588' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;halign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (horizontal alignment, &#39;left&#39;, &#39;center&#39;, or &#39;right&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t589' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;valign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (vertical alignment, &#39;baseline&#39;, &#39;center&#39;, or &#39;top&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t590' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;rotation&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t591' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (precedence of text when stacked with other objs)</span><span class='strut'>&nbsp;</span></p>
+<p id='t592' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t593' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t594' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t595' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; Attempting to draw a title\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t596' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>mpl_fig</span><span class='op'>.</span><span class='nam'>axes</span><span class='op'>)</span> <span class='op'>&gt;</span> <span class='num'>1</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t597' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; More than one subplot, adding title as &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
+<p id='t598' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;annotation\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t599' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x_px</span><span class='op'>,</span> <span class='nam'>y_px</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;mplobj&#39;</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>get_transform</span><span class='op'>(</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>transform</span><span class='op'>(</span><span class='nam'>props</span><span class='op'>[</span><span class='strut'>&nbsp;</span></p>
+<p id='t600' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;position&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t601' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>,</span> <span class='nam'>y</span> <span class='op'>=</span> <span class='nam'>mpltools</span><span class='op'>.</span><span class='nam'>display_to_paper</span><span class='op'>(</span><span class='nam'>x_px</span><span class='op'>,</span> <span class='nam'>y_px</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t602' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t603' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>annotation</span> <span class='op'>=</span> <span class='nam'>Annotation</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t604' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>text</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t605' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>font</span><span class='op'>=</span><span class='nam'>Font</span><span class='op'>(</span><span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;color&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t606' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>size</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;fontsize&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t607' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t608' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xref</span><span class='op'>=</span><span class='str'>&#39;paper&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t609' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yref</span><span class='op'>=</span><span class='str'>&#39;paper&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t610' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x</span><span class='op'>=</span><span class='nam'>x</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t611' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y</span><span class='op'>=</span><span class='nam'>y</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t612' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xanchor</span><span class='op'>=</span><span class='str'>&#39;center&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t613' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yanchor</span><span class='op'>=</span><span class='str'>&#39;bottom&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t614' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>showarrow</span><span class='op'>=</span><span class='nam'>False</span>&nbsp; <span class='com'># no arrow for a title!</span><span class='strut'>&nbsp;</span></p>
+<p id='t615' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t616' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;annotations&#39;</span><span class='op'>]</span> <span class='op'>+=</span> <span class='nam'>annotation</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t617' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t618' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Only one subplot found, adding as a &quot;</span> <span class='xx'>\</span><span class='strut'>&nbsp;</span></p>
+<p id='t619' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;plotly title\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t620' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;title&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t621' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>titlefont</span> <span class='op'>=</span> <span class='nam'>Font</span><span class='op'>(</span><span class='nam'>size</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;fontsize&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t622' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;color&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t623' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t624' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;titlefont&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>titlefont</span><span class='strut'>&nbsp;</span></p>
+<p id='t625' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t626' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_xlabel</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t627' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Add an xaxis label to the current subplot in layout dictionary.</span><span class='strut'>&nbsp;</span></p>
+<p id='t628' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t629' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t630' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text&#39;,&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (actual content string, not the text obj)</span><span class='strut'>&nbsp;</span></p>
+<p id='t631' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;position&#39;,&nbsp; &nbsp;&nbsp; (an x, y pair, not an mpl Bbox)</span><span class='strut'>&nbsp;</span></p>
+<p id='t632' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;coordinates&#39;,&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t633' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text_type&#39;,&nbsp; &nbsp; (&#39;title&#39;, &#39;xlabel&#39;, or &#39;ylabel&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t634' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;style&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (style dict, see below)</span><span class='strut'>&nbsp;</span></p>
+<p id='t635' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;&nbsp; &nbsp; &nbsp; &nbsp; (actual mpl text object)</span><span class='strut'>&nbsp;</span></p>
+<p id='t636' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t637' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t638' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;style&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t639' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of text)</span><span class='strut'>&nbsp;</span></p>
+<p id='t640' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;fontsize&#39;,&nbsp; &nbsp;&nbsp; (size in points of text)</span><span class='strut'>&nbsp;</span></p>
+<p id='t641' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;color&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (hex color)</span><span class='strut'>&nbsp;</span></p>
+<p id='t642' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;halign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (horizontal alignment, &#39;left&#39;, &#39;center&#39;, or &#39;right&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t643' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;valign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (vertical alignment, &#39;baseline&#39;, &#39;center&#39;, or &#39;top&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t644' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;rotation&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t645' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (precedence of text when stacked with other objs)</span><span class='strut'>&nbsp;</span></p>
+<p id='t646' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t647' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t648' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t649' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; Adding xlabel\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t650' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>axis_key</span> <span class='op'>=</span> <span class='str'>&#39;xaxis{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t651' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>axis_key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;title&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t652' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>titlefont</span> <span class='op'>=</span> <span class='nam'>Font</span><span class='op'>(</span><span class='nam'>size</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;fontsize&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t653' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;color&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t654' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>axis_key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;titlefont&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>titlefont</span><span class='strut'>&nbsp;</span></p>
+<p id='t655' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t656' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>draw_ylabel</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>props</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t657' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Add a yaxis label to the current subplot in layout dictionary.</span><span class='strut'>&nbsp;</span></p>
+<p id='t658' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t659' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props.keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t660' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text&#39;,&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (actual content string, not the text obj)</span><span class='strut'>&nbsp;</span></p>
+<p id='t661' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;position&#39;,&nbsp; &nbsp;&nbsp; (an x, y pair, not an mpl Bbox)</span><span class='strut'>&nbsp;</span></p>
+<p id='t662' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;coordinates&#39;,&nbsp; (&#39;data&#39;, &#39;axes&#39;, &#39;figure&#39;, &#39;display&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t663' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;text_type&#39;,&nbsp; &nbsp; (&#39;title&#39;, &#39;xlabel&#39;, or &#39;ylabel&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t664' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;style&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (style dict, see below)</span><span class='strut'>&nbsp;</span></p>
+<p id='t665' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;mplobj&#39;&nbsp; &nbsp; &nbsp; &nbsp; (actual mpl text object)</span><span class='strut'>&nbsp;</span></p>
+<p id='t666' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t667' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t668' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; props[&#39;style&#39;].keys() -- [</span><span class='strut'>&nbsp;</span></p>
+<p id='t669' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;alpha&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (opacity of text)</span><span class='strut'>&nbsp;</span></p>
+<p id='t670' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;fontsize&#39;,&nbsp; &nbsp;&nbsp; (size in points of text)</span><span class='strut'>&nbsp;</span></p>
+<p id='t671' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;color&#39;,&nbsp; &nbsp; &nbsp; &nbsp; (hex color)</span><span class='strut'>&nbsp;</span></p>
+<p id='t672' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;halign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (horizontal alignment, &#39;left&#39;, &#39;center&#39;, or &#39;right&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t673' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;valign&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (vertical alignment, &#39;baseline&#39;, &#39;center&#39;, or &#39;top&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t674' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;rotation&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t675' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;zorder&#39;,&nbsp; &nbsp; &nbsp;&nbsp; (precedence of text when stacked with other objs)</span><span class='strut'>&nbsp;</span></p>
+<p id='t676' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; ]</span><span class='strut'>&nbsp;</span></p>
+<p id='t677' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t678' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t679' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;&nbsp; &nbsp; &nbsp; &nbsp; Adding ylabel\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t680' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>axis_key</span> <span class='op'>=</span> <span class='str'>&#39;yaxis{0}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>.</span><span class='nam'>axis_ct</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t681' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>axis_key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;title&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;text&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t682' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>titlefont</span> <span class='op'>=</span> <span class='nam'>Font</span><span class='op'>(</span><span class='nam'>size</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;fontsize&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t683' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>color</span><span class='op'>=</span><span class='nam'>props</span><span class='op'>[</span><span class='str'>&#39;style&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;color&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t684' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>axis_key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;titlefont&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>titlefont</span><span class='strut'>&nbsp;</span></p>
+<p id='t685' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t686' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>resize</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t687' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Revert figure layout to allow plotly to resize.</span><span class='strut'>&nbsp;</span></p>
+<p id='t688' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t689' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; By default, PlotlyRenderer tries its hardest to precisely mimic an</span><span class='strut'>&nbsp;</span></p>
+<p id='t690' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; mpl figure. However, plotly is pretty good with aesthetics. By</span><span class='strut'>&nbsp;</span></p>
+<p id='t691' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; running PlotlyRenderer.resize(), layout parameters are deleted. This</span><span class='strut'>&nbsp;</span></p>
+<p id='t692' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; lets plotly choose them instead of mpl.</span><span class='strut'>&nbsp;</span></p>
+<p id='t693' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t694' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t695' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;Resizing figure, deleting keys from layout\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t696' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='op'>[</span><span class='str'>&#39;width&#39;</span><span class='op'>,</span> <span class='str'>&#39;height&#39;</span><span class='op'>,</span> <span class='str'>&#39;autosize&#39;</span><span class='op'>,</span> <span class='str'>&#39;margin&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t697' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t698' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t699' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t700' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t701' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t702' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>strip_style</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t703' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>msg</span> <span class='op'>+=</span> <span class='str'>&quot;Stripping mpl style, deleting keys from data and layout\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t704' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='op'>.</span><span class='nam'>strip_style</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
                 
             </td>
         </tr>
diff --git a/plotly/tests/coverage/plotly_plotly_plotly.html b/plotly/tests/coverage/plotly_plotly_plotly.html
--- a/plotly/tests/coverage/plotly_plotly_plotly.html
+++ b/plotly/tests/coverage/plotly_plotly_plotly.html
@@ -5,7 +5,7 @@
     
     
     <meta http-equiv='X-UA-Compatible' content='IE=emulateIE7' />
-    <title>Coverage for plotly/plotly/plotly: 42%</title>
+    <title>Coverage for plotly/plotly/plotly: 61%</title>
     <link rel='stylesheet' href='style.css' type='text/css'>
     
     <script type='text/javascript' src='jquery.min.js'></script>
@@ -21,13 +21,13 @@
 <div id='header'>
     <div class='content'>
         <h1>Coverage for <b>plotly/plotly/plotly</b> :
-            <span class='pc_cov'>42%</span>
+            <span class='pc_cov'>61%</span>
         </h1>
         <img id='keyboard_icon' src='keybd_closed.png'>
         <h2 class='stats'>
-            269 statements &nbsp;
-            <span class='run hide_run shortkey_r button_toggle_run'>114 run</span>
-            <span class='mis shortkey_m button_toggle_mis'>155 missing</span>
+            270 statements &nbsp;
+            <span class='run hide_run shortkey_r button_toggle_run'>166 run</span>
+            <span class='mis shortkey_m button_toggle_mis'>104 missing</span>
             <span class='exc shortkey_x button_toggle_exc'>0 excluded</span>
             
         </h2>
@@ -78,80 +78,80 @@ <h2 class='stats'>
 <p id='n15' class='pln'><a href='#n15'>15</a></p>
 <p id='n16' class='pln'><a href='#n16'>16</a></p>
 <p id='n17' class='stm run hide_run'><a href='#n17'>17</a></p>
-<p id='n18' class='stm run hide_run'><a href='#n18'>18</a></p>
+<p id='n18' class='pln'><a href='#n18'>18</a></p>
 <p id='n19' class='stm run hide_run'><a href='#n19'>19</a></p>
 <p id='n20' class='stm run hide_run'><a href='#n20'>20</a></p>
 <p id='n21' class='stm run hide_run'><a href='#n21'>21</a></p>
-<p id='n22' class='pln'><a href='#n22'>22</a></p>
+<p id='n22' class='stm run hide_run'><a href='#n22'>22</a></p>
 <p id='n23' class='stm run hide_run'><a href='#n23'>23</a></p>
 <p id='n24' class='pln'><a href='#n24'>24</a></p>
 <p id='n25' class='stm run hide_run'><a href='#n25'>25</a></p>
-<p id='n26' class='stm run hide_run'><a href='#n26'>26</a></p>
+<p id='n26' class='pln'><a href='#n26'>26</a></p>
 <p id='n27' class='stm run hide_run'><a href='#n27'>27</a></p>
 <p id='n28' class='stm run hide_run'><a href='#n28'>28</a></p>
 <p id='n29' class='stm run hide_run'><a href='#n29'>29</a></p>
-<p id='n30' class='pln'><a href='#n30'>30</a></p>
-<p id='n31' class='pln'><a href='#n31'>31</a></p>
-<p id='n32' class='stm run hide_run'><a href='#n32'>32</a></p>
+<p id='n30' class='stm run hide_run'><a href='#n30'>30</a></p>
+<p id='n31' class='stm run hide_run'><a href='#n31'>31</a></p>
+<p id='n32' class='pln'><a href='#n32'>32</a></p>
 <p id='n33' class='pln'><a href='#n33'>33</a></p>
-<p id='n34' class='pln'><a href='#n34'>34</a></p>
+<p id='n34' class='stm run hide_run'><a href='#n34'>34</a></p>
 <p id='n35' class='pln'><a href='#n35'>35</a></p>
-<p id='n36' class='stm run hide_run'><a href='#n36'>36</a></p>
+<p id='n36' class='pln'><a href='#n36'>36</a></p>
 <p id='n37' class='pln'><a href='#n37'>37</a></p>
-<p id='n38' class='pln'><a href='#n38'>38</a></p>
+<p id='n38' class='stm run hide_run'><a href='#n38'>38</a></p>
 <p id='n39' class='pln'><a href='#n39'>39</a></p>
 <p id='n40' class='pln'><a href='#n40'>40</a></p>
 <p id='n41' class='pln'><a href='#n41'>41</a></p>
 <p id='n42' class='pln'><a href='#n42'>42</a></p>
-<p id='n43' class='stm run hide_run'><a href='#n43'>43</a></p>
+<p id='n43' class='pln'><a href='#n43'>43</a></p>
 <p id='n44' class='pln'><a href='#n44'>44</a></p>
 <p id='n45' class='stm run hide_run'><a href='#n45'>45</a></p>
 <p id='n46' class='pln'><a href='#n46'>46</a></p>
-<p id='n47' class='pln'><a href='#n47'>47</a></p>
-<p id='n48' class='stm run hide_run'><a href='#n48'>48</a></p>
+<p id='n47' class='stm run hide_run'><a href='#n47'>47</a></p>
+<p id='n48' class='pln'><a href='#n48'>48</a></p>
 <p id='n49' class='pln'><a href='#n49'>49</a></p>
-<p id='n50' class='pln'><a href='#n50'>50</a></p>
+<p id='n50' class='stm run hide_run'><a href='#n50'>50</a></p>
 <p id='n51' class='pln'><a href='#n51'>51</a></p>
 <p id='n52' class='pln'><a href='#n52'>52</a></p>
-<p id='n53' class='stm run hide_run'><a href='#n53'>53</a></p>
+<p id='n53' class='pln'><a href='#n53'>53</a></p>
 <p id='n54' class='pln'><a href='#n54'>54</a></p>
-<p id='n55' class='pln'><a href='#n55'>55</a></p>
-<p id='n56' class='stm run hide_run'><a href='#n56'>56</a></p>
+<p id='n55' class='stm run hide_run'><a href='#n55'>55</a></p>
+<p id='n56' class='pln'><a href='#n56'>56</a></p>
 <p id='n57' class='pln'><a href='#n57'>57</a></p>
-<p id='n58' class='pln'><a href='#n58'>58</a></p>
+<p id='n58' class='stm run hide_run'><a href='#n58'>58</a></p>
 <p id='n59' class='pln'><a href='#n59'>59</a></p>
 <p id='n60' class='pln'><a href='#n60'>60</a></p>
 <p id='n61' class='pln'><a href='#n61'>61</a></p>
-<p id='n62' class='stm run hide_run'><a href='#n62'>62</a></p>
+<p id='n62' class='pln'><a href='#n62'>62</a></p>
 <p id='n63' class='pln'><a href='#n63'>63</a></p>
-<p id='n64' class='pln'><a href='#n64'>64</a></p>
+<p id='n64' class='stm run hide_run'><a href='#n64'>64</a></p>
 <p id='n65' class='pln'><a href='#n65'>65</a></p>
-<p id='n66' class='stm mis'><a href='#n66'>66</a></p>
+<p id='n66' class='pln'><a href='#n66'>66</a></p>
 <p id='n67' class='pln'><a href='#n67'>67</a></p>
-<p id='n68' class='pln'><a href='#n68'>68</a></p>
-<p id='n69' class='stm run hide_run'><a href='#n69'>69</a></p>
+<p id='n68' class='stm mis'><a href='#n68'>68</a></p>
+<p id='n69' class='pln'><a href='#n69'>69</a></p>
 <p id='n70' class='pln'><a href='#n70'>70</a></p>
-<p id='n71' class='pln'><a href='#n71'>71</a></p>
+<p id='n71' class='stm run hide_run'><a href='#n71'>71</a></p>
 <p id='n72' class='pln'><a href='#n72'>72</a></p>
 <p id='n73' class='pln'><a href='#n73'>73</a></p>
-<p id='n74' class='stm mis'><a href='#n74'>74</a></p>
+<p id='n74' class='pln'><a href='#n74'>74</a></p>
 <p id='n75' class='pln'><a href='#n75'>75</a></p>
-<p id='n76' class='pln'><a href='#n76'>76</a></p>
-<p id='n77' class='stm run hide_run'><a href='#n77'>77</a></p>
+<p id='n76' class='stm mis'><a href='#n76'>76</a></p>
+<p id='n77' class='pln'><a href='#n77'>77</a></p>
 <p id='n78' class='pln'><a href='#n78'>78</a></p>
-<p id='n79' class='pln'><a href='#n79'>79</a></p>
+<p id='n79' class='stm run hide_run'><a href='#n79'>79</a></p>
 <p id='n80' class='pln'><a href='#n80'>80</a></p>
-<p id='n81' class='stm mis'><a href='#n81'>81</a></p>
-<p id='n82' class='stm mis'><a href='#n82'>82</a></p>
-<p id='n83' class='pln'><a href='#n83'>83</a></p>
-<p id='n84' class='stm mis'><a href='#n84'>84</a></p>
+<p id='n81' class='pln'><a href='#n81'>81</a></p>
+<p id='n82' class='pln'><a href='#n82'>82</a></p>
+<p id='n83' class='stm run hide_run'><a href='#n83'>83</a></p>
+<p id='n84' class='stm run hide_run'><a href='#n84'>84</a></p>
 <p id='n85' class='pln'><a href='#n85'>85</a></p>
-<p id='n86' class='pln'><a href='#n86'>86</a></p>
+<p id='n86' class='stm run hide_run'><a href='#n86'>86</a></p>
 <p id='n87' class='pln'><a href='#n87'>87</a></p>
 <p id='n88' class='pln'><a href='#n88'>88</a></p>
-<p id='n89' class='stm run hide_run'><a href='#n89'>89</a></p>
+<p id='n89' class='pln'><a href='#n89'>89</a></p>
 <p id='n90' class='pln'><a href='#n90'>90</a></p>
-<p id='n91' class='pln'><a href='#n91'>91</a></p>
+<p id='n91' class='stm run hide_run'><a href='#n91'>91</a></p>
 <p id='n92' class='pln'><a href='#n92'>92</a></p>
 <p id='n93' class='pln'><a href='#n93'>93</a></p>
 <p id='n94' class='pln'><a href='#n94'>94</a></p>
@@ -162,37 +162,37 @@ <h2 class='stats'>
 <p id='n99' class='pln'><a href='#n99'>99</a></p>
 <p id='n100' class='pln'><a href='#n100'>100</a></p>
 <p id='n101' class='pln'><a href='#n101'>101</a></p>
-<p id='n102' class='stm mis'><a href='#n102'>102</a></p>
-<p id='n103' class='stm mis'><a href='#n103'>103</a></p>
+<p id='n102' class='pln'><a href='#n102'>102</a></p>
+<p id='n103' class='pln'><a href='#n103'>103</a></p>
 <p id='n104' class='stm mis'><a href='#n104'>104</a></p>
 <p id='n105' class='stm mis'><a href='#n105'>105</a></p>
 <p id='n106' class='stm mis'><a href='#n106'>106</a></p>
-<p id='n107' class='pln'><a href='#n107'>107</a></p>
+<p id='n107' class='stm mis'><a href='#n107'>107</a></p>
 <p id='n108' class='stm mis'><a href='#n108'>108</a></p>
-<p id='n109' class='stm mis'><a href='#n109'>109</a></p>
+<p id='n109' class='pln'><a href='#n109'>109</a></p>
 <p id='n110' class='stm mis'><a href='#n110'>110</a></p>
 <p id='n111' class='stm mis'><a href='#n111'>111</a></p>
 <p id='n112' class='stm mis'><a href='#n112'>112</a></p>
-<p id='n113' class='pln'><a href='#n113'>113</a></p>
+<p id='n113' class='stm mis'><a href='#n113'>113</a></p>
 <p id='n114' class='stm mis'><a href='#n114'>114</a></p>
 <p id='n115' class='pln'><a href='#n115'>115</a></p>
-<p id='n116' class='pln'><a href='#n116'>116</a></p>
-<p id='n117' class='stm run hide_run'><a href='#n117'>117</a></p>
+<p id='n116' class='stm mis'><a href='#n116'>116</a></p>
+<p id='n117' class='pln'><a href='#n117'>117</a></p>
 <p id='n118' class='pln'><a href='#n118'>118</a></p>
 <p id='n119' class='stm run hide_run'><a href='#n119'>119</a></p>
-<p id='n120' class='stm run hide_run'><a href='#n120'>120</a></p>
+<p id='n120' class='pln'><a href='#n120'>120</a></p>
 <p id='n121' class='stm run hide_run'><a href='#n121'>121</a></p>
 <p id='n122' class='stm run hide_run'><a href='#n122'>122</a></p>
 <p id='n123' class='stm run hide_run'><a href='#n123'>123</a></p>
-<p id='n124' class='pln'><a href='#n124'>124</a></p>
-<p id='n125' class='pln'><a href='#n125'>125</a></p>
-<p id='n126' class='stm run hide_run'><a href='#n126'>126</a></p>
-<p id='n127' class='stm run hide_run'><a href='#n127'>127</a></p>
-<p id='n128' class='pln'><a href='#n128'>128</a></p>
-<p id='n129' class='pln'><a href='#n129'>129</a></p>
-<p id='n130' class='stm run hide_run'><a href='#n130'>130</a></p>
+<p id='n124' class='stm run hide_run'><a href='#n124'>124</a></p>
+<p id='n125' class='stm run hide_run'><a href='#n125'>125</a></p>
+<p id='n126' class='pln'><a href='#n126'>126</a></p>
+<p id='n127' class='pln'><a href='#n127'>127</a></p>
+<p id='n128' class='stm run hide_run'><a href='#n128'>128</a></p>
+<p id='n129' class='stm run hide_run'><a href='#n129'>129</a></p>
+<p id='n130' class='pln'><a href='#n130'>130</a></p>
 <p id='n131' class='pln'><a href='#n131'>131</a></p>
-<p id='n132' class='pln'><a href='#n132'>132</a></p>
+<p id='n132' class='stm run hide_run'><a href='#n132'>132</a></p>
 <p id='n133' class='pln'><a href='#n133'>133</a></p>
 <p id='n134' class='pln'><a href='#n134'>134</a></p>
 <p id='n135' class='pln'><a href='#n135'>135</a></p>
@@ -206,33 +206,33 @@ <h2 class='stats'>
 <p id='n143' class='pln'><a href='#n143'>143</a></p>
 <p id='n144' class='pln'><a href='#n144'>144</a></p>
 <p id='n145' class='pln'><a href='#n145'>145</a></p>
-<p id='n146' class='stm run hide_run'><a href='#n146'>146</a></p>
-<p id='n147' class='stm run hide_run'><a href='#n147'>147</a></p>
-<p id='n148' class='stm mis'><a href='#n148'>148</a></p>
-<p id='n149' class='stm mis'><a href='#n149'>149</a></p>
-<p id='n150' class='pln'><a href='#n150'>150</a></p>
-<p id='n151' class='stm mis'><a href='#n151'>151</a></p>
+<p id='n146' class='pln'><a href='#n146'>146</a></p>
+<p id='n147' class='pln'><a href='#n147'>147</a></p>
+<p id='n148' class='stm run hide_run'><a href='#n148'>148</a></p>
+<p id='n149' class='stm run hide_run'><a href='#n149'>149</a></p>
+<p id='n150' class='stm run hide_run'><a href='#n150'>150</a></p>
+<p id='n151' class='stm run hide_run'><a href='#n151'>151</a></p>
 <p id='n152' class='pln'><a href='#n152'>152</a></p>
-<p id='n153' class='pln'><a href='#n153'>153</a></p>
-<p id='n154' class='stm run hide_run'><a href='#n154'>154</a></p>
-<p id='n155' class='stm run hide_run'><a href='#n155'>155</a></p>
+<p id='n153' class='stm mis'><a href='#n153'>153</a></p>
+<p id='n154' class='pln'><a href='#n154'>154</a></p>
+<p id='n155' class='pln'><a href='#n155'>155</a></p>
 <p id='n156' class='stm run hide_run'><a href='#n156'>156</a></p>
-<p id='n157' class='stm mis'><a href='#n157'>157</a></p>
-<p id='n158' class='stm mis'><a href='#n158'>158</a></p>
-<p id='n159' class='pln'><a href='#n159'>159</a></p>
-<p id='n160' class='pln'><a href='#n160'>160</a></p>
+<p id='n157' class='stm run hide_run'><a href='#n157'>157</a></p>
+<p id='n158' class='stm run hide_run'><a href='#n158'>158</a></p>
+<p id='n159' class='stm run hide_run'><a href='#n159'>159</a></p>
+<p id='n160' class='stm run hide_run'><a href='#n160'>160</a></p>
 <p id='n161' class='pln'><a href='#n161'>161</a></p>
 <p id='n162' class='pln'><a href='#n162'>162</a></p>
 <p id='n163' class='pln'><a href='#n163'>163</a></p>
 <p id='n164' class='pln'><a href='#n164'>164</a></p>
 <p id='n165' class='pln'><a href='#n165'>165</a></p>
-<p id='n166' class='stm run hide_run'><a href='#n166'>166</a></p>
-<p id='n167' class='stm run hide_run'><a href='#n167'>167</a></p>
+<p id='n166' class='pln'><a href='#n166'>166</a></p>
+<p id='n167' class='pln'><a href='#n167'>167</a></p>
 <p id='n168' class='stm run hide_run'><a href='#n168'>168</a></p>
 <p id='n169' class='stm run hide_run'><a href='#n169'>169</a></p>
-<p id='n170' class='stm mis'><a href='#n170'>170</a></p>
-<p id='n171' class='pln'><a href='#n171'>171</a></p>
-<p id='n172' class='pln'><a href='#n172'>172</a></p>
+<p id='n170' class='stm run hide_run'><a href='#n170'>170</a></p>
+<p id='n171' class='stm run hide_run'><a href='#n171'>171</a></p>
+<p id='n172' class='stm mis'><a href='#n172'>172</a></p>
 <p id='n173' class='pln'><a href='#n173'>173</a></p>
 <p id='n174' class='pln'><a href='#n174'>174</a></p>
 <p id='n175' class='pln'><a href='#n175'>175</a></p>
@@ -243,26 +243,26 @@ <h2 class='stats'>
 <p id='n180' class='pln'><a href='#n180'>180</a></p>
 <p id='n181' class='pln'><a href='#n181'>181</a></p>
 <p id='n182' class='pln'><a href='#n182'>182</a></p>
-<p id='n183' class='stm mis'><a href='#n183'>183</a></p>
-<p id='n184' class='stm mis'><a href='#n184'>184</a></p>
+<p id='n183' class='pln'><a href='#n183'>183</a></p>
+<p id='n184' class='pln'><a href='#n184'>184</a></p>
 <p id='n185' class='stm mis'><a href='#n185'>185</a></p>
-<p id='n186' class='stm run hide_run'><a href='#n186'>186</a></p>
-<p id='n187' class='stm run hide_run'><a href='#n187'>187</a></p>
+<p id='n186' class='stm mis'><a href='#n186'>186</a></p>
+<p id='n187' class='stm mis'><a href='#n187'>187</a></p>
 <p id='n188' class='stm run hide_run'><a href='#n188'>188</a></p>
 <p id='n189' class='stm run hide_run'><a href='#n189'>189</a></p>
-<p id='n190' class='stm mis'><a href='#n190'>190</a></p>
-<p id='n191' class='stm mis'><a href='#n191'>191</a></p>
+<p id='n190' class='stm run hide_run'><a href='#n190'>190</a></p>
+<p id='n191' class='stm run hide_run'><a href='#n191'>191</a></p>
 <p id='n192' class='stm mis'><a href='#n192'>192</a></p>
 <p id='n193' class='stm mis'><a href='#n193'>193</a></p>
 <p id='n194' class='stm mis'><a href='#n194'>194</a></p>
-<p id='n195' class='stm run hide_run'><a href='#n195'>195</a></p>
-<p id='n196' class='pln'><a href='#n196'>196</a></p>
-<p id='n197' class='stm mis'><a href='#n197'>197</a></p>
+<p id='n195' class='stm mis'><a href='#n195'>195</a></p>
+<p id='n196' class='stm mis'><a href='#n196'>196</a></p>
+<p id='n197' class='stm run hide_run'><a href='#n197'>197</a></p>
 <p id='n198' class='pln'><a href='#n198'>198</a></p>
-<p id='n199' class='pln'><a href='#n199'>199</a></p>
-<p id='n200' class='stm run hide_run'><a href='#n200'>200</a></p>
+<p id='n199' class='stm mis'><a href='#n199'>199</a></p>
+<p id='n200' class='pln'><a href='#n200'>200</a></p>
 <p id='n201' class='pln'><a href='#n201'>201</a></p>
-<p id='n202' class='pln'><a href='#n202'>202</a></p>
+<p id='n202' class='stm run hide_run'><a href='#n202'>202</a></p>
 <p id='n203' class='pln'><a href='#n203'>203</a></p>
 <p id='n204' class='pln'><a href='#n204'>204</a></p>
 <p id='n205' class='pln'><a href='#n205'>205</a></p>
@@ -281,8 +281,8 @@ <h2 class='stats'>
 <p id='n218' class='pln'><a href='#n218'>218</a></p>
 <p id='n219' class='pln'><a href='#n219'>219</a></p>
 <p id='n220' class='pln'><a href='#n220'>220</a></p>
-<p id='n221' class='stm mis'><a href='#n221'>221</a></p>
-<p id='n222' class='stm mis'><a href='#n222'>222</a></p>
+<p id='n221' class='pln'><a href='#n221'>221</a></p>
+<p id='n222' class='pln'><a href='#n222'>222</a></p>
 <p id='n223' class='stm mis'><a href='#n223'>223</a></p>
 <p id='n224' class='stm mis'><a href='#n224'>224</a></p>
 <p id='n225' class='stm mis'><a href='#n225'>225</a></p>
@@ -292,15 +292,15 @@ <h2 class='stats'>
 <p id='n229' class='stm mis'><a href='#n229'>229</a></p>
 <p id='n230' class='stm mis'><a href='#n230'>230</a></p>
 <p id='n231' class='stm mis'><a href='#n231'>231</a></p>
-<p id='n232' class='pln'><a href='#n232'>232</a></p>
-<p id='n233' class='pln'><a href='#n233'>233</a></p>
+<p id='n232' class='stm mis'><a href='#n232'>232</a></p>
+<p id='n233' class='stm mis'><a href='#n233'>233</a></p>
 <p id='n234' class='pln'><a href='#n234'>234</a></p>
-<p id='n235' class='stm mis'><a href='#n235'>235</a></p>
+<p id='n235' class='pln'><a href='#n235'>235</a></p>
 <p id='n236' class='pln'><a href='#n236'>236</a></p>
-<p id='n237' class='pln'><a href='#n237'>237</a></p>
-<p id='n238' class='stm run hide_run'><a href='#n238'>238</a></p>
+<p id='n237' class='stm mis'><a href='#n237'>237</a></p>
+<p id='n238' class='pln'><a href='#n238'>238</a></p>
 <p id='n239' class='pln'><a href='#n239'>239</a></p>
-<p id='n240' class='pln'><a href='#n240'>240</a></p>
+<p id='n240' class='stm run hide_run'><a href='#n240'>240</a></p>
 <p id='n241' class='pln'><a href='#n241'>241</a></p>
 <p id='n242' class='pln'><a href='#n242'>242</a></p>
 <p id='n243' class='pln'><a href='#n243'>243</a></p>
@@ -319,8 +319,8 @@ <h2 class='stats'>
 <p id='n256' class='pln'><a href='#n256'>256</a></p>
 <p id='n257' class='pln'><a href='#n257'>257</a></p>
 <p id='n258' class='pln'><a href='#n258'>258</a></p>
-<p id='n259' class='stm run hide_run'><a href='#n259'>259</a></p>
-<p id='n260' class='stm run hide_run'><a href='#n260'>260</a></p>
+<p id='n259' class='pln'><a href='#n259'>259</a></p>
+<p id='n260' class='pln'><a href='#n260'>260</a></p>
 <p id='n261' class='stm run hide_run'><a href='#n261'>261</a></p>
 <p id='n262' class='stm run hide_run'><a href='#n262'>262</a></p>
 <p id='n263' class='stm run hide_run'><a href='#n263'>263</a></p>
@@ -330,15 +330,15 @@ <h2 class='stats'>
 <p id='n267' class='stm run hide_run'><a href='#n267'>267</a></p>
 <p id='n268' class='stm run hide_run'><a href='#n268'>268</a></p>
 <p id='n269' class='stm run hide_run'><a href='#n269'>269</a></p>
-<p id='n270' class='pln'><a href='#n270'>270</a></p>
-<p id='n271' class='pln'><a href='#n271'>271</a></p>
+<p id='n270' class='stm run hide_run'><a href='#n270'>270</a></p>
+<p id='n271' class='stm run hide_run'><a href='#n271'>271</a></p>
 <p id='n272' class='pln'><a href='#n272'>272</a></p>
-<p id='n273' class='stm run hide_run'><a href='#n273'>273</a></p>
+<p id='n273' class='pln'><a href='#n273'>273</a></p>
 <p id='n274' class='pln'><a href='#n274'>274</a></p>
-<p id='n275' class='pln'><a href='#n275'>275</a></p>
-<p id='n276' class='stm run hide_run'><a href='#n276'>276</a></p>
+<p id='n275' class='stm run hide_run'><a href='#n275'>275</a></p>
+<p id='n276' class='pln'><a href='#n276'>276</a></p>
 <p id='n277' class='pln'><a href='#n277'>277</a></p>
-<p id='n278' class='pln'><a href='#n278'>278</a></p>
+<p id='n278' class='stm run hide_run'><a href='#n278'>278</a></p>
 <p id='n279' class='pln'><a href='#n279'>279</a></p>
 <p id='n280' class='pln'><a href='#n280'>280</a></p>
 <p id='n281' class='pln'><a href='#n281'>281</a></p>
@@ -363,66 +363,66 @@ <h2 class='stats'>
 <p id='n300' class='pln'><a href='#n300'>300</a></p>
 <p id='n301' class='pln'><a href='#n301'>301</a></p>
 <p id='n302' class='pln'><a href='#n302'>302</a></p>
-<p id='n303' class='stm run hide_run'><a href='#n303'>303</a></p>
-<p id='n304' class='stm run hide_run'><a href='#n304'>304</a></p>
-<p id='n305' class='stm mis'><a href='#n305'>305</a></p>
-<p id='n306' class='stm mis'><a href='#n306'>306</a></p>
-<p id='n307' class='stm mis'><a href='#n307'>307</a></p>
-<p id='n308' class='pln'><a href='#n308'>308</a></p>
-<p id='n309' class='pln'><a href='#n309'>309</a></p>
+<p id='n303' class='pln'><a href='#n303'>303</a></p>
+<p id='n304' class='pln'><a href='#n304'>304</a></p>
+<p id='n305' class='stm run hide_run'><a href='#n305'>305</a></p>
+<p id='n306' class='stm run hide_run'><a href='#n306'>306</a></p>
+<p id='n307' class='stm run hide_run'><a href='#n307'>307</a></p>
+<p id='n308' class='stm run hide_run'><a href='#n308'>308</a></p>
+<p id='n309' class='stm mis'><a href='#n309'>309</a></p>
 <p id='n310' class='pln'><a href='#n310'>310</a></p>
 <p id='n311' class='pln'><a href='#n311'>311</a></p>
 <p id='n312' class='pln'><a href='#n312'>312</a></p>
-<p id='n313' class='stm mis'><a href='#n313'>313</a></p>
-<p id='n314' class='stm mis'><a href='#n314'>314</a></p>
-<p id='n315' class='stm mis'><a href='#n315'>315</a></p>
-<p id='n316' class='pln'><a href='#n316'>316</a></p>
+<p id='n313' class='pln'><a href='#n313'>313</a></p>
+<p id='n314' class='pln'><a href='#n314'>314</a></p>
+<p id='n315' class='stm run hide_run'><a href='#n315'>315</a></p>
+<p id='n316' class='stm run hide_run'><a href='#n316'>316</a></p>
 <p id='n317' class='stm run hide_run'><a href='#n317'>317</a></p>
-<p id='n318' class='stm run hide_run'><a href='#n318'>318</a></p>
-<p id='n319' class='pln'><a href='#n319'>319</a></p>
+<p id='n318' class='pln'><a href='#n318'>318</a></p>
+<p id='n319' class='stm run hide_run'><a href='#n319'>319</a></p>
 <p id='n320' class='stm run hide_run'><a href='#n320'>320</a></p>
-<p id='n321' class='stm run hide_run'><a href='#n321'>321</a></p>
-<p id='n322' class='pln'><a href='#n322'>322</a></p>
-<p id='n323' class='pln'><a href='#n323'>323</a></p>
+<p id='n321' class='pln'><a href='#n321'>321</a></p>
+<p id='n322' class='stm run hide_run'><a href='#n322'>322</a></p>
+<p id='n323' class='stm run hide_run'><a href='#n323'>323</a></p>
 <p id='n324' class='pln'><a href='#n324'>324</a></p>
-<p id='n325' class='stm run hide_run'><a href='#n325'>325</a></p>
-<p id='n326' class='stm run hide_run'><a href='#n326'>326</a></p>
-<p id='n327' class='stm mis'><a href='#n327'>327</a></p>
-<p id='n328' class='stm mis'><a href='#n328'>328</a></p>
-<p id='n329' class='pln'><a href='#n329'>329</a></p>
-<p id='n330' class='pln'><a href='#n330'>330</a></p>
+<p id='n325' class='pln'><a href='#n325'>325</a></p>
+<p id='n326' class='pln'><a href='#n326'>326</a></p>
+<p id='n327' class='stm run hide_run'><a href='#n327'>327</a></p>
+<p id='n328' class='stm run hide_run'><a href='#n328'>328</a></p>
+<p id='n329' class='stm run hide_run'><a href='#n329'>329</a></p>
+<p id='n330' class='stm run hide_run'><a href='#n330'>330</a></p>
 <p id='n331' class='pln'><a href='#n331'>331</a></p>
 <p id='n332' class='pln'><a href='#n332'>332</a></p>
 <p id='n333' class='pln'><a href='#n333'>333</a></p>
-<p id='n334' class='stm run hide_run'><a href='#n334'>334</a></p>
-<p id='n335' class='stm mis'><a href='#n335'>335</a></p>
-<p id='n336' class='pln'><a href='#n336'>336</a></p>
-<p id='n337' class='pln'><a href='#n337'>337</a></p>
-<p id='n338' class='stm run hide_run'><a href='#n338'>338</a></p>
-<p id='n339' class='stm run hide_run'><a href='#n339'>339</a></p>
+<p id='n334' class='pln'><a href='#n334'>334</a></p>
+<p id='n335' class='pln'><a href='#n335'>335</a></p>
+<p id='n336' class='stm run hide_run'><a href='#n336'>336</a></p>
+<p id='n337' class='stm run hide_run'><a href='#n337'>337</a></p>
+<p id='n338' class='pln'><a href='#n338'>338</a></p>
+<p id='n339' class='pln'><a href='#n339'>339</a></p>
 <p id='n340' class='stm run hide_run'><a href='#n340'>340</a></p>
-<p id='n341' class='stm mis'><a href='#n341'>341</a></p>
-<p id='n342' class='pln'><a href='#n342'>342</a></p>
-<p id='n343' class='stm run hide_run'><a href='#n343'>343</a></p>
-<p id='n344' class='stm run hide_run'><a href='#n344'>344</a></p>
+<p id='n341' class='stm run hide_run'><a href='#n341'>341</a></p>
+<p id='n342' class='stm run hide_run'><a href='#n342'>342</a></p>
+<p id='n343' class='stm mis'><a href='#n343'>343</a></p>
+<p id='n344' class='pln'><a href='#n344'>344</a></p>
 <p id='n345' class='stm run hide_run'><a href='#n345'>345</a></p>
 <p id='n346' class='stm run hide_run'><a href='#n346'>346</a></p>
 <p id='n347' class='stm run hide_run'><a href='#n347'>347</a></p>
-<p id='n348' class='stm mis'><a href='#n348'>348</a></p>
-<p id='n349' class='pln'><a href='#n349'>349</a></p>
+<p id='n348' class='stm run hide_run'><a href='#n348'>348</a></p>
+<p id='n349' class='stm run hide_run'><a href='#n349'>349</a></p>
 <p id='n350' class='stm run hide_run'><a href='#n350'>350</a></p>
 <p id='n351' class='pln'><a href='#n351'>351</a></p>
-<p id='n352' class='stm mis'><a href='#n352'>352</a></p>
-<p id='n353' class='stm mis'><a href='#n353'>353</a></p>
-<p id='n354' class='stm mis'><a href='#n354'>354</a></p>
-<p id='n355' class='stm mis'><a href='#n355'>355</a></p>
-<p id='n356' class='stm mis'><a href='#n356'>356</a></p>
-<p id='n357' class='pln'><a href='#n357'>357</a></p>
-<p id='n358' class='pln'><a href='#n358'>358</a></p>
+<p id='n352' class='stm run hide_run'><a href='#n352'>352</a></p>
+<p id='n353' class='pln'><a href='#n353'>353</a></p>
+<p id='n354' class='stm run hide_run'><a href='#n354'>354</a></p>
+<p id='n355' class='stm run hide_run'><a href='#n355'>355</a></p>
+<p id='n356' class='stm run hide_run'><a href='#n356'>356</a></p>
+<p id='n357' class='stm run hide_run'><a href='#n357'>357</a></p>
+<p id='n358' class='stm run hide_run'><a href='#n358'>358</a></p>
 <p id='n359' class='pln'><a href='#n359'>359</a></p>
-<p id='n360' class='stm run hide_run'><a href='#n360'>360</a></p>
+<p id='n360' class='pln'><a href='#n360'>360</a></p>
 <p id='n361' class='pln'><a href='#n361'>361</a></p>
-<p id='n362' class='pln'><a href='#n362'>362</a></p>
+<p id='n362' class='stm run hide_run'><a href='#n362'>362</a></p>
 <p id='n363' class='pln'><a href='#n363'>363</a></p>
 <p id='n364' class='pln'><a href='#n364'>364</a></p>
 <p id='n365' class='pln'><a href='#n365'>365</a></p>
@@ -448,35 +448,35 @@ <h2 class='stats'>
 <p id='n385' class='pln'><a href='#n385'>385</a></p>
 <p id='n386' class='pln'><a href='#n386'>386</a></p>
 <p id='n387' class='pln'><a href='#n387'>387</a></p>
-<p id='n388' class='stm run hide_run'><a href='#n388'>388</a></p>
+<p id='n388' class='pln'><a href='#n388'>388</a></p>
 <p id='n389' class='pln'><a href='#n389'>389</a></p>
-<p id='n390' class='pln'><a href='#n390'>390</a></p>
+<p id='n390' class='stm run hide_run'><a href='#n390'>390</a></p>
 <p id='n391' class='pln'><a href='#n391'>391</a></p>
 <p id='n392' class='pln'><a href='#n392'>392</a></p>
 <p id='n393' class='pln'><a href='#n393'>393</a></p>
 <p id='n394' class='pln'><a href='#n394'>394</a></p>
 <p id='n395' class='pln'><a href='#n395'>395</a></p>
 <p id='n396' class='pln'><a href='#n396'>396</a></p>
-<p id='n397' class='stm mis'><a href='#n397'>397</a></p>
-<p id='n398' class='stm mis'><a href='#n398'>398</a></p>
-<p id='n399' class='pln'><a href='#n399'>399</a></p>
+<p id='n397' class='pln'><a href='#n397'>397</a></p>
+<p id='n398' class='pln'><a href='#n398'>398</a></p>
+<p id='n399' class='stm run hide_run'><a href='#n399'>399</a></p>
 <p id='n400' class='stm run hide_run'><a href='#n400'>400</a></p>
 <p id='n401' class='pln'><a href='#n401'>401</a></p>
-<p id='n402' class='pln'><a href='#n402'>402</a></p>
+<p id='n402' class='stm run hide_run'><a href='#n402'>402</a></p>
 <p id='n403' class='pln'><a href='#n403'>403</a></p>
 <p id='n404' class='pln'><a href='#n404'>404</a></p>
 <p id='n405' class='pln'><a href='#n405'>405</a></p>
 <p id='n406' class='pln'><a href='#n406'>406</a></p>
 <p id='n407' class='pln'><a href='#n407'>407</a></p>
-<p id='n408' class='stm mis'><a href='#n408'>408</a></p>
-<p id='n409' class='stm mis'><a href='#n409'>409</a></p>
-<p id='n410' class='pln'><a href='#n410'>410</a></p>
-<p id='n411' class='pln'><a href='#n411'>411</a></p>
+<p id='n408' class='pln'><a href='#n408'>408</a></p>
+<p id='n409' class='pln'><a href='#n409'>409</a></p>
+<p id='n410' class='stm run hide_run'><a href='#n410'>410</a></p>
+<p id='n411' class='stm run hide_run'><a href='#n411'>411</a></p>
 <p id='n412' class='pln'><a href='#n412'>412</a></p>
 <p id='n413' class='pln'><a href='#n413'>413</a></p>
-<p id='n414' class='stm run hide_run'><a href='#n414'>414</a></p>
+<p id='n414' class='pln'><a href='#n414'>414</a></p>
 <p id='n415' class='pln'><a href='#n415'>415</a></p>
-<p id='n416' class='pln'><a href='#n416'>416</a></p>
+<p id='n416' class='stm run hide_run'><a href='#n416'>416</a></p>
 <p id='n417' class='pln'><a href='#n417'>417</a></p>
 <p id='n418' class='pln'><a href='#n418'>418</a></p>
 <p id='n419' class='pln'><a href='#n419'>419</a></p>
@@ -512,248 +512,250 @@ <h2 class='stats'>
 <p id='n449' class='pln'><a href='#n449'>449</a></p>
 <p id='n450' class='pln'><a href='#n450'>450</a></p>
 <p id='n451' class='pln'><a href='#n451'>451</a></p>
-<p id='n452' class='stm mis'><a href='#n452'>452</a></p>
-<p id='n453' class='stm mis'><a href='#n453'>453</a></p>
-<p id='n454' class='stm mis'><a href='#n454'>454</a></p>
-<p id='n455' class='stm mis'><a href='#n455'>455</a></p>
-<p id='n456' class='stm mis'><a href='#n456'>456</a></p>
-<p id='n457' class='stm mis'><a href='#n457'>457</a></p>
-<p id='n458' class='stm mis'><a href='#n458'>458</a></p>
-<p id='n459' class='stm mis'><a href='#n459'>459</a></p>
-<p id='n460' class='stm mis'><a href='#n460'>460</a></p>
-<p id='n461' class='pln'><a href='#n461'>461</a></p>
-<p id='n462' class='pln'><a href='#n462'>462</a></p>
+<p id='n452' class='pln'><a href='#n452'>452</a></p>
+<p id='n453' class='pln'><a href='#n453'>453</a></p>
+<p id='n454' class='stm run hide_run'><a href='#n454'>454</a></p>
+<p id='n455' class='stm run hide_run'><a href='#n455'>455</a></p>
+<p id='n456' class='stm run hide_run'><a href='#n456'>456</a></p>
+<p id='n457' class='stm run hide_run'><a href='#n457'>457</a></p>
+<p id='n458' class='stm run hide_run'><a href='#n458'>458</a></p>
+<p id='n459' class='stm run hide_run'><a href='#n459'>459</a></p>
+<p id='n460' class='stm run hide_run'><a href='#n460'>460</a></p>
+<p id='n461' class='stm run hide_run'><a href='#n461'>461</a></p>
+<p id='n462' class='stm run hide_run'><a href='#n462'>462</a></p>
 <p id='n463' class='pln'><a href='#n463'>463</a></p>
 <p id='n464' class='pln'><a href='#n464'>464</a></p>
 <p id='n465' class='pln'><a href='#n465'>465</a></p>
 <p id='n466' class='pln'><a href='#n466'>466</a></p>
 <p id='n467' class='pln'><a href='#n467'>467</a></p>
-<p id='n468' class='stm mis'><a href='#n468'>468</a></p>
-<p id='n469' class='stm mis'><a href='#n469'>469</a></p>
-<p id='n470' class='stm mis'><a href='#n470'>470</a></p>
-<p id='n471' class='stm mis'><a href='#n471'>471</a></p>
-<p id='n472' class='pln'><a href='#n472'>472</a></p>
-<p id='n473' class='pln'><a href='#n473'>473</a></p>
+<p id='n468' class='pln'><a href='#n468'>468</a></p>
+<p id='n469' class='pln'><a href='#n469'>469</a></p>
+<p id='n470' class='stm run hide_run'><a href='#n470'>470</a></p>
+<p id='n471' class='stm run hide_run'><a href='#n471'>471</a></p>
+<p id='n472' class='stm run hide_run'><a href='#n472'>472</a></p>
+<p id='n473' class='stm run hide_run'><a href='#n473'>473</a></p>
 <p id='n474' class='pln'><a href='#n474'>474</a></p>
 <p id='n475' class='pln'><a href='#n475'>475</a></p>
 <p id='n476' class='pln'><a href='#n476'>476</a></p>
 <p id='n477' class='pln'><a href='#n477'>477</a></p>
 <p id='n478' class='pln'><a href='#n478'>478</a></p>
-<p id='n479' class='stm mis'><a href='#n479'>479</a></p>
-<p id='n480' class='stm mis'><a href='#n480'>480</a></p>
-<p id='n481' class='stm mis'><a href='#n481'>481</a></p>
-<p id='n482' class='stm mis'><a href='#n482'>482</a></p>
-<p id='n483' class='stm mis'><a href='#n483'>483</a></p>
-<p id='n484' class='pln'><a href='#n484'>484</a></p>
-<p id='n485' class='pln'><a href='#n485'>485</a></p>
+<p id='n479' class='pln'><a href='#n479'>479</a></p>
+<p id='n480' class='pln'><a href='#n480'>480</a></p>
+<p id='n481' class='stm run hide_run'><a href='#n481'>481</a></p>
+<p id='n482' class='stm run hide_run'><a href='#n482'>482</a></p>
+<p id='n483' class='stm run hide_run'><a href='#n483'>483</a></p>
+<p id='n484' class='stm mis'><a href='#n484'>484</a></p>
+<p id='n485' class='stm mis'><a href='#n485'>485</a></p>
 <p id='n486' class='pln'><a href='#n486'>486</a></p>
-<p id='n487' class='stm mis'><a href='#n487'>487</a></p>
+<p id='n487' class='pln'><a href='#n487'>487</a></p>
 <p id='n488' class='pln'><a href='#n488'>488</a></p>
-<p id='n489' class='stm mis'><a href='#n489'>489</a></p>
-<p id='n490' class='stm mis'><a href='#n490'>490</a></p>
-<p id='n491' class='pln'><a href='#n491'>491</a></p>
-<p id='n492' class='pln'><a href='#n492'>492</a></p>
-<p id='n493' class='stm mis'><a href='#n493'>493</a></p>
-<p id='n494' class='stm mis'><a href='#n494'>494</a></p>
-<p id='n495' class='pln'><a href='#n495'>495</a></p>
-<p id='n496' class='stm mis'><a href='#n496'>496</a></p>
-<p id='n497' class='stm mis'><a href='#n497'>497</a></p>
-<p id='n498' class='stm mis'><a href='#n498'>498</a></p>
-<p id='n499' class='stm mis'><a href='#n499'>499</a></p>
-<p id='n500' class='pln'><a href='#n500'>500</a></p>
-<p id='n501' class='pln'><a href='#n501'>501</a></p>
+<p id='n489' class='stm run hide_run'><a href='#n489'>489</a></p>
+<p id='n490' class='pln'><a href='#n490'>490</a></p>
+<p id='n491' class='stm run hide_run'><a href='#n491'>491</a></p>
+<p id='n492' class='stm run hide_run'><a href='#n492'>492</a></p>
+<p id='n493' class='pln'><a href='#n493'>493</a></p>
+<p id='n494' class='pln'><a href='#n494'>494</a></p>
+<p id='n495' class='stm run hide_run'><a href='#n495'>495</a></p>
+<p id='n496' class='stm run hide_run'><a href='#n496'>496</a></p>
+<p id='n497' class='pln'><a href='#n497'>497</a></p>
+<p id='n498' class='stm run hide_run'><a href='#n498'>498</a></p>
+<p id='n499' class='stm run hide_run'><a href='#n499'>499</a></p>
+<p id='n500' class='stm mis'><a href='#n500'>500</a></p>
+<p id='n501' class='stm mis'><a href='#n501'>501</a></p>
 <p id='n502' class='pln'><a href='#n502'>502</a></p>
-<p id='n503' class='stm run hide_run'><a href='#n503'>503</a></p>
+<p id='n503' class='pln'><a href='#n503'>503</a></p>
 <p id='n504' class='pln'><a href='#n504'>504</a></p>
-<p id='n505' class='pln'><a href='#n505'>505</a></p>
+<p id='n505' class='stm run hide_run'><a href='#n505'>505</a></p>
 <p id='n506' class='pln'><a href='#n506'>506</a></p>
 <p id='n507' class='pln'><a href='#n507'>507</a></p>
 <p id='n508' class='pln'><a href='#n508'>508</a></p>
 <p id='n509' class='pln'><a href='#n509'>509</a></p>
-<p id='n510' class='stm mis'><a href='#n510'>510</a></p>
-<p id='n511' class='stm mis'><a href='#n511'>511</a></p>
-<p id='n512' class='stm mis'><a href='#n512'>512</a></p>
-<p id='n513' class='stm mis'><a href='#n513'>513</a></p>
-<p id='n514' class='pln'><a href='#n514'>514</a></p>
-<p id='n515' class='pln'><a href='#n515'>515</a></p>
-<p id='n516' class='stm run hide_run'><a href='#n516'>516</a></p>
+<p id='n510' class='pln'><a href='#n510'>510</a></p>
+<p id='n511' class='pln'><a href='#n511'>511</a></p>
+<p id='n512' class='stm run hide_run'><a href='#n512'>512</a></p>
+<p id='n513' class='stm run hide_run'><a href='#n513'>513</a></p>
+<p id='n514' class='stm mis'><a href='#n514'>514</a></p>
+<p id='n515' class='stm mis'><a href='#n515'>515</a></p>
+<p id='n516' class='pln'><a href='#n516'>516</a></p>
 <p id='n517' class='pln'><a href='#n517'>517</a></p>
-<p id='n518' class='pln'><a href='#n518'>518</a></p>
+<p id='n518' class='stm run hide_run'><a href='#n518'>518</a></p>
 <p id='n519' class='pln'><a href='#n519'>519</a></p>
-<p id='n520' class='stm run hide_run'><a href='#n520'>520</a></p>
-<p id='n521' class='stm run hide_run'><a href='#n521'>521</a></p>
-<p id='n522' class='pln'><a href='#n522'>522</a></p>
-<p id='n523' class='pln'><a href='#n523'>523</a></p>
+<p id='n520' class='pln'><a href='#n520'>520</a></p>
+<p id='n521' class='pln'><a href='#n521'>521</a></p>
+<p id='n522' class='stm run hide_run'><a href='#n522'>522</a></p>
+<p id='n523' class='stm run hide_run'><a href='#n523'>523</a></p>
 <p id='n524' class='pln'><a href='#n524'>524</a></p>
 <p id='n525' class='pln'><a href='#n525'>525</a></p>
-<p id='n526' class='stm mis'><a href='#n526'>526</a></p>
-<p id='n527' class='stm mis'><a href='#n527'>527</a></p>
+<p id='n526' class='pln'><a href='#n526'>526</a></p>
+<p id='n527' class='pln'><a href='#n527'>527</a></p>
 <p id='n528' class='stm mis'><a href='#n528'>528</a></p>
 <p id='n529' class='stm mis'><a href='#n529'>529</a></p>
-<p id='n530' class='pln'><a href='#n530'>530</a></p>
+<p id='n530' class='stm mis'><a href='#n530'>530</a></p>
 <p id='n531' class='stm mis'><a href='#n531'>531</a></p>
-<p id='n532' class='stm mis'><a href='#n532'>532</a></p>
-<p id='n533' class='pln'><a href='#n533'>533</a></p>
-<p id='n534' class='pln'><a href='#n534'>534</a></p>
+<p id='n532' class='pln'><a href='#n532'>532</a></p>
+<p id='n533' class='stm mis'><a href='#n533'>533</a></p>
+<p id='n534' class='stm mis'><a href='#n534'>534</a></p>
 <p id='n535' class='pln'><a href='#n535'>535</a></p>
 <p id='n536' class='pln'><a href='#n536'>536</a></p>
 <p id='n537' class='pln'><a href='#n537'>537</a></p>
 <p id='n538' class='pln'><a href='#n538'>538</a></p>
 <p id='n539' class='pln'><a href='#n539'>539</a></p>
 <p id='n540' class='pln'><a href='#n540'>540</a></p>
-<p id='n541' class='stm mis'><a href='#n541'>541</a></p>
-<p id='n542' class='stm mis'><a href='#n542'>542</a></p>
-<p id='n543' class='pln'><a href='#n543'>543</a></p>
-<p id='n544' class='pln'><a href='#n544'>544</a></p>
+<p id='n541' class='pln'><a href='#n541'>541</a></p>
+<p id='n542' class='pln'><a href='#n542'>542</a></p>
+<p id='n543' class='stm mis'><a href='#n543'>543</a></p>
+<p id='n544' class='stm mis'><a href='#n544'>544</a></p>
 <p id='n545' class='pln'><a href='#n545'>545</a></p>
 <p id='n546' class='pln'><a href='#n546'>546</a></p>
-<p id='n547' class='stm mis'><a href='#n547'>547</a></p>
+<p id='n547' class='pln'><a href='#n547'>547</a></p>
 <p id='n548' class='pln'><a href='#n548'>548</a></p>
-<p id='n549' class='pln'><a href='#n549'>549</a></p>
+<p id='n549' class='stm mis'><a href='#n549'>549</a></p>
 <p id='n550' class='pln'><a href='#n550'>550</a></p>
 <p id='n551' class='pln'><a href='#n551'>551</a></p>
-<p id='n552' class='stm mis'><a href='#n552'>552</a></p>
-<p id='n553' class='stm mis'><a href='#n553'>553</a></p>
+<p id='n552' class='pln'><a href='#n552'>552</a></p>
+<p id='n553' class='pln'><a href='#n553'>553</a></p>
 <p id='n554' class='stm mis'><a href='#n554'>554</a></p>
 <p id='n555' class='stm mis'><a href='#n555'>555</a></p>
-<p id='n556' class='pln'><a href='#n556'>556</a></p>
+<p id='n556' class='stm mis'><a href='#n556'>556</a></p>
 <p id='n557' class='stm mis'><a href='#n557'>557</a></p>
-<p id='n558' class='stm mis'><a href='#n558'>558</a></p>
-<p id='n559' class='pln'><a href='#n559'>559</a></p>
-<p id='n560' class='pln'><a href='#n560'>560</a></p>
+<p id='n558' class='pln'><a href='#n558'>558</a></p>
+<p id='n559' class='stm mis'><a href='#n559'>559</a></p>
+<p id='n560' class='stm mis'><a href='#n560'>560</a></p>
 <p id='n561' class='pln'><a href='#n561'>561</a></p>
 <p id='n562' class='pln'><a href='#n562'>562</a></p>
-<p id='n563' class='stm mis'><a href='#n563'>563</a></p>
+<p id='n563' class='pln'><a href='#n563'>563</a></p>
 <p id='n564' class='pln'><a href='#n564'>564</a></p>
 <p id='n565' class='stm mis'><a href='#n565'>565</a></p>
-<p id='n566' class='stm mis'><a href='#n566'>566</a></p>
-<p id='n567' class='pln'><a href='#n567'>567</a></p>
-<p id='n568' class='pln'><a href='#n568'>568</a></p>
+<p id='n566' class='pln'><a href='#n566'>566</a></p>
+<p id='n567' class='stm mis'><a href='#n567'>567</a></p>
+<p id='n568' class='stm mis'><a href='#n568'>568</a></p>
 <p id='n569' class='pln'><a href='#n569'>569</a></p>
-<p id='n570' class='stm mis'><a href='#n570'>570</a></p>
+<p id='n570' class='pln'><a href='#n570'>570</a></p>
 <p id='n571' class='pln'><a href='#n571'>571</a></p>
 <p id='n572' class='stm mis'><a href='#n572'>572</a></p>
 <p id='n573' class='pln'><a href='#n573'>573</a></p>
 <p id='n574' class='stm mis'><a href='#n574'>574</a></p>
-<p id='n575' class='stm mis'><a href='#n575'>575</a></p>
-<p id='n576' class='pln'><a href='#n576'>576</a></p>
+<p id='n575' class='pln'><a href='#n575'>575</a></p>
+<p id='n576' class='stm mis'><a href='#n576'>576</a></p>
 <p id='n577' class='stm mis'><a href='#n577'>577</a></p>
-<p id='n578' class='stm mis'><a href='#n578'>578</a></p>
-<p id='n579' class='pln'><a href='#n579'>579</a></p>
+<p id='n578' class='pln'><a href='#n578'>578</a></p>
+<p id='n579' class='stm mis'><a href='#n579'>579</a></p>
 <p id='n580' class='stm mis'><a href='#n580'>580</a></p>
 <p id='n581' class='pln'><a href='#n581'>581</a></p>
 <p id='n582' class='stm mis'><a href='#n582'>582</a></p>
-<p id='n583' class='stm mis'><a href='#n583'>583</a></p>
+<p id='n583' class='pln'><a href='#n583'>583</a></p>
 <p id='n584' class='stm mis'><a href='#n584'>584</a></p>
-<p id='n585' class='pln'><a href='#n585'>585</a></p>
-<p id='n586' class='pln'><a href='#n586'>586</a></p>
-<p id='n587' class='stm mis'><a href='#n587'>587</a></p>
+<p id='n585' class='stm mis'><a href='#n585'>585</a></p>
+<p id='n586' class='stm mis'><a href='#n586'>586</a></p>
+<p id='n587' class='pln'><a href='#n587'>587</a></p>
 <p id='n588' class='pln'><a href='#n588'>588</a></p>
-<p id='n589' class='pln'><a href='#n589'>589</a></p>
-<p id='n590' class='stm run hide_run'><a href='#n590'>590</a></p>
-<p id='n591' class='stm run hide_run'><a href='#n591'>591</a></p>
-<p id='n592' class='pln'><a href='#n592'>592</a></p>
-<p id='n593' class='pln'><a href='#n593'>593</a></p>
+<p id='n589' class='stm mis'><a href='#n589'>589</a></p>
+<p id='n590' class='pln'><a href='#n590'>590</a></p>
+<p id='n591' class='pln'><a href='#n591'>591</a></p>
+<p id='n592' class='stm run hide_run'><a href='#n592'>592</a></p>
+<p id='n593' class='stm run hide_run'><a href='#n593'>593</a></p>
 <p id='n594' class='pln'><a href='#n594'>594</a></p>
-<p id='n595' class='stm mis'><a href='#n595'>595</a></p>
-<p id='n596' class='stm mis'><a href='#n596'>596</a></p>
-<p id='n597' class='pln'><a href='#n597'>597</a></p>
-<p id='n598' class='pln'><a href='#n598'>598</a></p>
+<p id='n595' class='pln'><a href='#n595'>595</a></p>
+<p id='n596' class='pln'><a href='#n596'>596</a></p>
+<p id='n597' class='stm mis'><a href='#n597'>597</a></p>
+<p id='n598' class='stm mis'><a href='#n598'>598</a></p>
 <p id='n599' class='pln'><a href='#n599'>599</a></p>
 <p id='n600' class='pln'><a href='#n600'>600</a></p>
-<p id='n601' class='stm mis'><a href='#n601'>601</a></p>
-<p id='n602' class='stm mis'><a href='#n602'>602</a></p>
+<p id='n601' class='pln'><a href='#n601'>601</a></p>
+<p id='n602' class='pln'><a href='#n602'>602</a></p>
 <p id='n603' class='stm mis'><a href='#n603'>603</a></p>
 <p id='n604' class='stm mis'><a href='#n604'>604</a></p>
-<p id='n605' class='pln'><a href='#n605'>605</a></p>
+<p id='n605' class='stm mis'><a href='#n605'>605</a></p>
 <p id='n606' class='stm mis'><a href='#n606'>606</a></p>
 <p id='n607' class='pln'><a href='#n607'>607</a></p>
-<p id='n608' class='stm run hide_run'><a href='#n608'>608</a></p>
-<p id='n609' class='stm run hide_run'><a href='#n609'>609</a></p>
-<p id='n610' class='pln'><a href='#n610'>610</a></p>
-<p id='n611' class='pln'><a href='#n611'>611</a></p>
+<p id='n608' class='stm mis'><a href='#n608'>608</a></p>
+<p id='n609' class='pln'><a href='#n609'>609</a></p>
+<p id='n610' class='stm run hide_run'><a href='#n610'>610</a></p>
+<p id='n611' class='stm run hide_run'><a href='#n611'>611</a></p>
 <p id='n612' class='pln'><a href='#n612'>612</a></p>
 <p id='n613' class='pln'><a href='#n613'>613</a></p>
-<p id='n614' class='stm mis'><a href='#n614'>614</a></p>
-<p id='n615' class='stm mis'><a href='#n615'>615</a></p>
+<p id='n614' class='pln'><a href='#n614'>614</a></p>
+<p id='n615' class='pln'><a href='#n615'>615</a></p>
 <p id='n616' class='stm mis'><a href='#n616'>616</a></p>
 <p id='n617' class='stm mis'><a href='#n617'>617</a></p>
 <p id='n618' class='stm mis'><a href='#n618'>618</a></p>
 <p id='n619' class='stm mis'><a href='#n619'>619</a></p>
 <p id='n620' class='stm mis'><a href='#n620'>620</a></p>
-<p id='n621' class='pln'><a href='#n621'>621</a></p>
+<p id='n621' class='stm mis'><a href='#n621'>621</a></p>
 <p id='n622' class='stm mis'><a href='#n622'>622</a></p>
 <p id='n623' class='pln'><a href='#n623'>623</a></p>
 <p id='n624' class='stm mis'><a href='#n624'>624</a></p>
 <p id='n625' class='pln'><a href='#n625'>625</a></p>
 <p id='n626' class='stm mis'><a href='#n626'>626</a></p>
-<p id='n627' class='stm mis'><a href='#n627'>627</a></p>
+<p id='n627' class='pln'><a href='#n627'>627</a></p>
 <p id='n628' class='stm mis'><a href='#n628'>628</a></p>
-<p id='n629' class='pln'><a href='#n629'>629</a></p>
-<p id='n630' class='pln'><a href='#n630'>630</a></p>
-<p id='n631' class='stm run hide_run'><a href='#n631'>631</a></p>
+<p id='n629' class='stm mis'><a href='#n629'>629</a></p>
+<p id='n630' class='stm mis'><a href='#n630'>630</a></p>
+<p id='n631' class='pln'><a href='#n631'>631</a></p>
 <p id='n632' class='pln'><a href='#n632'>632</a></p>
-<p id='n633' class='pln'><a href='#n633'>633</a></p>
-<p id='n634' class='stm run hide_run'><a href='#n634'>634</a></p>
-<p id='n635' class='stm run hide_run'><a href='#n635'>635</a></p>
-<p id='n636' class='pln'><a href='#n636'>636</a></p>
+<p id='n633' class='stm run hide_run'><a href='#n633'>633</a></p>
+<p id='n634' class='pln'><a href='#n634'>634</a></p>
+<p id='n635' class='pln'><a href='#n635'>635</a></p>
+<p id='n636' class='stm run hide_run'><a href='#n636'>636</a></p>
 <p id='n637' class='stm run hide_run'><a href='#n637'>637</a></p>
-<p id='n638' class='stm run hide_run'><a href='#n638'>638</a></p>
+<p id='n638' class='pln'><a href='#n638'>638</a></p>
 <p id='n639' class='stm run hide_run'><a href='#n639'>639</a></p>
-<p id='n640' class='stm mis'><a href='#n640'>640</a></p>
-<p id='n641' class='stm mis'><a href='#n641'>641</a></p>
-<p id='n642' class='pln'><a href='#n642'>642</a></p>
-<p id='n643' class='pln'><a href='#n643'>643</a></p>
-<p id='n644' class='stm mis'><a href='#n644'>644</a></p>
+<p id='n640' class='stm run hide_run'><a href='#n640'>640</a></p>
+<p id='n641' class='stm run hide_run'><a href='#n641'>641</a></p>
+<p id='n642' class='stm mis'><a href='#n642'>642</a></p>
+<p id='n643' class='stm mis'><a href='#n643'>643</a></p>
+<p id='n644' class='pln'><a href='#n644'>644</a></p>
 <p id='n645' class='pln'><a href='#n645'>645</a></p>
-<p id='n646' class='stm run hide_run'><a href='#n646'>646</a></p>
+<p id='n646' class='stm mis'><a href='#n646'>646</a></p>
 <p id='n647' class='pln'><a href='#n647'>647</a></p>
-<p id='n648' class='pln'><a href='#n648'>648</a></p>
+<p id='n648' class='stm run hide_run'><a href='#n648'>648</a></p>
 <p id='n649' class='pln'><a href='#n649'>649</a></p>
 <p id='n650' class='pln'><a href='#n650'>650</a></p>
 <p id='n651' class='pln'><a href='#n651'>651</a></p>
 <p id='n652' class='pln'><a href='#n652'>652</a></p>
 <p id='n653' class='pln'><a href='#n653'>653</a></p>
-<p id='n654' class='stm run hide_run'><a href='#n654'>654</a></p>
+<p id='n654' class='pln'><a href='#n654'>654</a></p>
 <p id='n655' class='pln'><a href='#n655'>655</a></p>
-<p id='n656' class='pln'><a href='#n656'>656</a></p>
+<p id='n656' class='stm run hide_run'><a href='#n656'>656</a></p>
 <p id='n657' class='pln'><a href='#n657'>657</a></p>
 <p id='n658' class='pln'><a href='#n658'>658</a></p>
 <p id='n659' class='pln'><a href='#n659'>659</a></p>
 <p id='n660' class='pln'><a href='#n660'>660</a></p>
 <p id='n661' class='pln'><a href='#n661'>661</a></p>
-<p id='n662' class='stm run hide_run'><a href='#n662'>662</a></p>
+<p id='n662' class='pln'><a href='#n662'>662</a></p>
 <p id='n663' class='pln'><a href='#n663'>663</a></p>
 <p id='n664' class='stm run hide_run'><a href='#n664'>664</a></p>
-<p id='n665' class='stm run hide_run'><a href='#n665'>665</a></p>
+<p id='n665' class='pln'><a href='#n665'>665</a></p>
 <p id='n666' class='stm run hide_run'><a href='#n666'>666</a></p>
 <p id='n667' class='stm run hide_run'><a href='#n667'>667</a></p>
-<p id='n668' class='stm mis'><a href='#n668'>668</a></p>
+<p id='n668' class='stm run hide_run'><a href='#n668'>668</a></p>
 <p id='n669' class='stm run hide_run'><a href='#n669'>669</a></p>
 <p id='n670' class='stm mis'><a href='#n670'>670</a></p>
 <p id='n671' class='stm run hide_run'><a href='#n671'>671</a></p>
 <p id='n672' class='stm mis'><a href='#n672'>672</a></p>
-<p id='n673' class='pln'><a href='#n673'>673</a></p>
+<p id='n673' class='stm run hide_run'><a href='#n673'>673</a></p>
 <p id='n674' class='stm run hide_run'><a href='#n674'>674</a></p>
 <p id='n675' class='pln'><a href='#n675'>675</a></p>
-<p id='n676' class='pln'><a href='#n676'>676</a></p>
-<p id='n677' class='stm run hide_run'><a href='#n677'>677</a></p>
-<p id='n678' class='stm run hide_run'><a href='#n678'>678</a></p>
+<p id='n676' class='stm run hide_run'><a href='#n676'>676</a></p>
+<p id='n677' class='pln'><a href='#n677'>677</a></p>
+<p id='n678' class='pln'><a href='#n678'>678</a></p>
 <p id='n679' class='stm run hide_run'><a href='#n679'>679</a></p>
 <p id='n680' class='stm run hide_run'><a href='#n680'>680</a></p>
-<p id='n681' class='stm mis'><a href='#n681'>681</a></p>
-<p id='n682' class='stm mis'><a href='#n682'>682</a></p>
-<p id='n683' class='pln'><a href='#n683'>683</a></p>
+<p id='n681' class='stm run hide_run'><a href='#n681'>681</a></p>
+<p id='n682' class='stm run hide_run'><a href='#n682'>682</a></p>
+<p id='n683' class='stm mis'><a href='#n683'>683</a></p>
 <p id='n684' class='stm mis'><a href='#n684'>684</a></p>
-<p id='n685' class='stm run hide_run'><a href='#n685'>685</a></p>
-<p id='n686' class='stm run hide_run'><a href='#n686'>686</a></p>
-<p id='n687' class='stm mis'><a href='#n687'>687</a></p>
-<p id='n688' class='stm mis'><a href='#n688'>688</a></p>
-<p id='n689' class='pln'><a href='#n689'>689</a></p>
+<p id='n685' class='pln'><a href='#n685'>685</a></p>
+<p id='n686' class='stm mis'><a href='#n686'>686</a></p>
+<p id='n687' class='stm run hide_run'><a href='#n687'>687</a></p>
+<p id='n688' class='stm run hide_run'><a href='#n688'>688</a></p>
+<p id='n689' class='stm mis'><a href='#n689'>689</a></p>
 <p id='n690' class='stm mis'><a href='#n690'>690</a></p>
-<p id='n691' class='stm run hide_run'><a href='#n691'>691</a></p>
+<p id='n691' class='pln'><a href='#n691'>691</a></p>
 <p id='n692' class='stm mis'><a href='#n692'>692</a></p>
 <p id='n693' class='stm run hide_run'><a href='#n693'>693</a></p>
+<p id='n694' class='stm mis'><a href='#n694'>694</a></p>
+<p id='n695' class='stm run hide_run'><a href='#n695'>695</a></p>
                 
             </td>
             <td class='text' valign='top'>
@@ -773,683 +775,685 @@ <h2 class='stats'>
 <p id='t14' class='pln'><span class='str'>4. update plot_options with kwargs!</span><span class='strut'>&nbsp;</span></p>
 <p id='t15' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t16' class='pln'><span class='str'>&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t17' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>json</span><span class='strut'>&nbsp;</span></p>
-<p id='t18' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>warnings</span><span class='strut'>&nbsp;</span></p>
-<p id='t19' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>copy</span><span class='strut'>&nbsp;</span></p>
-<p id='t20' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>os</span><span class='strut'>&nbsp;</span></p>
-<p id='t21' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>six</span><span class='strut'>&nbsp;</span></p>
-<p id='t22' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t23' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>requests</span><span class='strut'>&nbsp;</span></p>
+<p id='t17' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>__future__</span> <span class='key'>import</span> <span class='nam'>absolute_import</span><span class='strut'>&nbsp;</span></p>
+<p id='t18' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t19' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>json</span><span class='strut'>&nbsp;</span></p>
+<p id='t20' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>warnings</span><span class='strut'>&nbsp;</span></p>
+<p id='t21' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>copy</span><span class='strut'>&nbsp;</span></p>
+<p id='t22' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>os</span><span class='strut'>&nbsp;</span></p>
+<p id='t23' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>six</span><span class='strut'>&nbsp;</span></p>
 <p id='t24' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t25' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span> <span class='key'>import</span> <span class='nam'>chunked_requests</span><span class='strut'>&nbsp;</span></p>
-<p id='t26' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span><span class='op'>.</span> <span class='key'>import</span> <span class='nam'>utils</span>&nbsp; <span class='com'># TODO make non-relative</span><span class='strut'>&nbsp;</span></p>
-<p id='t27' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span><span class='op'>.</span> <span class='key'>import</span> <span class='nam'>tools</span><span class='strut'>&nbsp;</span></p>
-<p id='t28' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span><span class='op'>.</span> <span class='key'>import</span> <span class='nam'>exceptions</span><span class='strut'>&nbsp;</span></p>
-<p id='t29' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span><span class='op'>.</span> <span class='key'>import</span> <span class='nam'>version</span><span class='strut'>&nbsp;</span></p>
-<p id='t30' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t31' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t32' class='stm run hide_run'><span class='nam'>__all__</span> <span class='op'>=</span> <span class='op'>[</span><span class='str'>&quot;sign_in&quot;</span><span class='op'>,</span> <span class='str'>&quot;update_plot_options&quot;</span><span class='op'>,</span> <span class='str'>&quot;get_plot_options&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t33' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;get_credentials&quot;</span><span class='op'>,</span> <span class='str'>&quot;iplot&quot;</span><span class='op'>,</span> <span class='str'>&quot;plot&quot;</span><span class='op'>,</span> <span class='str'>&quot;iplot_mpl&quot;</span><span class='op'>,</span> <span class='str'>&quot;plot_mpl&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t34' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;get_figure&quot;</span><span class='op'>,</span> <span class='str'>&quot;Stream&quot;</span><span class='op'>,</span> <span class='str'>&quot;image&quot;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t35' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t36' class='stm run hide_run'><span class='nam'>_DEFAULT_PLOT_OPTIONS</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t37' class='pln'>&nbsp; &nbsp; <span class='nam'>filename</span><span class='op'>=</span><span class='str'>&quot;plot from API&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t38' class='pln'>&nbsp; &nbsp; <span class='nam'>fileopt</span><span class='op'>=</span><span class='str'>&quot;new&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t39' class='pln'>&nbsp; &nbsp; <span class='nam'>world_readable</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t40' class='pln'>&nbsp; &nbsp; <span class='nam'>auto_open</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t41' class='pln'>&nbsp; &nbsp; <span class='nam'>validate</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t42' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t43' class='stm run hide_run'><span class='nam'>_credentials</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t25' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>requests</span><span class='strut'>&nbsp;</span></p>
+<p id='t26' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t27' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>plotly</span><span class='op'>.</span><span class='nam'>plotly</span> <span class='key'>import</span> <span class='nam'>chunked_requests</span><span class='strut'>&nbsp;</span></p>
+<p id='t28' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>plotly</span> <span class='key'>import</span> <span class='nam'>utils</span><span class='strut'>&nbsp;</span></p>
+<p id='t29' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>plotly</span> <span class='key'>import</span> <span class='nam'>tools</span><span class='strut'>&nbsp;</span></p>
+<p id='t30' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>plotly</span> <span class='key'>import</span> <span class='nam'>exceptions</span><span class='strut'>&nbsp;</span></p>
+<p id='t31' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>plotly</span> <span class='key'>import</span> <span class='nam'>version</span><span class='strut'>&nbsp;</span></p>
+<p id='t32' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t33' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t34' class='stm run hide_run'><span class='nam'>__all__</span> <span class='op'>=</span> <span class='op'>[</span><span class='str'>&quot;sign_in&quot;</span><span class='op'>,</span> <span class='str'>&quot;update_plot_options&quot;</span><span class='op'>,</span> <span class='str'>&quot;get_plot_options&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t35' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;get_credentials&quot;</span><span class='op'>,</span> <span class='str'>&quot;iplot&quot;</span><span class='op'>,</span> <span class='str'>&quot;plot&quot;</span><span class='op'>,</span> <span class='str'>&quot;iplot_mpl&quot;</span><span class='op'>,</span> <span class='str'>&quot;plot_mpl&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t36' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;get_figure&quot;</span><span class='op'>,</span> <span class='str'>&quot;Stream&quot;</span><span class='op'>,</span> <span class='str'>&quot;image&quot;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t37' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t38' class='stm run hide_run'><span class='nam'>_DEFAULT_PLOT_OPTIONS</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t39' class='pln'>&nbsp; &nbsp; <span class='nam'>filename</span><span class='op'>=</span><span class='str'>&quot;plot from API&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t40' class='pln'>&nbsp; &nbsp; <span class='nam'>fileopt</span><span class='op'>=</span><span class='str'>&quot;new&quot;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t41' class='pln'>&nbsp; &nbsp; <span class='nam'>world_readable</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t42' class='pln'>&nbsp; &nbsp; <span class='nam'>auto_open</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t43' class='pln'>&nbsp; &nbsp; <span class='nam'>validate</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
 <p id='t44' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t45' class='stm run hide_run'><span class='nam'>_plot_options</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t45' class='stm run hide_run'><span class='nam'>_credentials</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
 <p id='t46' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t47' class='pln'><span class='com'>### test file permissions and make sure nothing is corrupted ###</span><span class='strut'>&nbsp;</span></p>
-<p id='t48' class='stm run hide_run'><span class='nam'>tools</span><span class='op'>.</span><span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t49' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t50' class='pln'><span class='com'>### _credentials stuff ###</span><span class='strut'>&nbsp;</span></p>
+<p id='t47' class='stm run hide_run'><span class='nam'>_plot_options</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t48' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t49' class='pln'><span class='com'>### test file permissions and make sure nothing is corrupted ###</span><span class='strut'>&nbsp;</span></p>
+<p id='t50' class='stm run hide_run'><span class='nam'>tools</span><span class='op'>.</span><span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
 <p id='t51' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t52' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t53' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>sign_in</span><span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t54' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Set module-scoped _credentials for session. Verify with plotly.&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t55' class='pln'>&nbsp; &nbsp; <span class='key'>global</span> <span class='nam'>_credentials</span><span class='strut'>&nbsp;</span></p>
-<p id='t56' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>_credentials</span><span class='op'>[</span><span class='str'>&#39;username&#39;</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>_credentials</span><span class='op'>[</span><span class='str'>&#39;api_key&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='strut'>&nbsp;</span></p>
-<p id='t57' class='pln'>&nbsp; &nbsp; <span class='com'># TODO: verify these _credentials with plotly</span><span class='strut'>&nbsp;</span></p>
-<p id='t58' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t59' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t60' class='pln'><span class='com'>### plot options stuff ###</span><span class='strut'>&nbsp;</span></p>
+<p id='t52' class='pln'><span class='com'>### _credentials stuff ###</span><span class='strut'>&nbsp;</span></p>
+<p id='t53' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t54' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t55' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>sign_in</span><span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t56' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Set module-scoped _credentials for session. Verify with plotly.&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t57' class='pln'>&nbsp; &nbsp; <span class='key'>global</span> <span class='nam'>_credentials</span><span class='strut'>&nbsp;</span></p>
+<p id='t58' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>_credentials</span><span class='op'>[</span><span class='str'>&#39;username&#39;</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>_credentials</span><span class='op'>[</span><span class='str'>&#39;api_key&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='strut'>&nbsp;</span></p>
+<p id='t59' class='pln'>&nbsp; &nbsp; <span class='com'># TODO: verify these _credentials with plotly</span><span class='strut'>&nbsp;</span></p>
+<p id='t60' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t61' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t62' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>update_plot_options</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t63' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Update the module-level _plot_options</span><span class='strut'>&nbsp;</span></p>
-<p id='t64' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t65' class='pln'>&nbsp; &nbsp; <span class='key'>global</span> <span class='nam'>_plot_options</span><span class='strut'>&nbsp;</span></p>
-<p id='t66' class='stm mis'>&nbsp; &nbsp; <span class='nam'>_plot_options</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t67' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t68' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t69' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_plot_options</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t70' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Returns a copy of the user supplied plot options.</span><span class='strut'>&nbsp;</span></p>
-<p id='t71' class='pln'><span class='str'>&nbsp; &nbsp; Use `update_plot_options()` to change.</span><span class='strut'>&nbsp;</span></p>
-<p id='t72' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t73' class='pln'>&nbsp; &nbsp; <span class='key'>global</span> <span class='nam'>_plot_options</span><span class='strut'>&nbsp;</span></p>
-<p id='t74' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>copy</span><span class='op'>.</span><span class='nam'>copy</span><span class='op'>(</span><span class='nam'>_plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t75' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t76' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t77' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_credentials</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t78' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Returns a copy of the user supplied credentials.</span><span class='strut'>&nbsp;</span></p>
-<p id='t79' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t80' class='pln'>&nbsp; &nbsp; <span class='key'>global</span> <span class='nam'>_credentials</span><span class='strut'>&nbsp;</span></p>
-<p id='t81' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;username&#39;</span> <span class='key'>in</span> <span class='nam'>_credentials</span><span class='op'>)</span> <span class='key'>and</span> <span class='op'>(</span><span class='str'>&#39;api_key&#39;</span> <span class='key'>in</span> <span class='nam'>_credentials</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t82' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>copy</span><span class='op'>.</span><span class='nam'>copy</span><span class='op'>(</span><span class='nam'>_credentials</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t83' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t84' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_credentials_file</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t85' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t86' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t87' class='pln'><span class='com'>### plot stuff ###</span><span class='strut'>&nbsp;</span></p>
+<p id='t62' class='pln'><span class='com'>### plot options stuff ###</span><span class='strut'>&nbsp;</span></p>
+<p id='t63' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t64' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>update_plot_options</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t65' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Update the module-level _plot_options</span><span class='strut'>&nbsp;</span></p>
+<p id='t66' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t67' class='pln'>&nbsp; &nbsp; <span class='key'>global</span> <span class='nam'>_plot_options</span><span class='strut'>&nbsp;</span></p>
+<p id='t68' class='stm mis'>&nbsp; &nbsp; <span class='nam'>_plot_options</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t69' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t70' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t71' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_plot_options</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t72' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Returns a copy of the user supplied plot options.</span><span class='strut'>&nbsp;</span></p>
+<p id='t73' class='pln'><span class='str'>&nbsp; &nbsp; Use `update_plot_options()` to change.</span><span class='strut'>&nbsp;</span></p>
+<p id='t74' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t75' class='pln'>&nbsp; &nbsp; <span class='key'>global</span> <span class='nam'>_plot_options</span><span class='strut'>&nbsp;</span></p>
+<p id='t76' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>copy</span><span class='op'>.</span><span class='nam'>copy</span><span class='op'>(</span><span class='nam'>_plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t77' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t78' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t79' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_credentials</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t80' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Returns a copy of the user supplied credentials.</span><span class='strut'>&nbsp;</span></p>
+<p id='t81' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t82' class='pln'>&nbsp; &nbsp; <span class='key'>global</span> <span class='nam'>_credentials</span><span class='strut'>&nbsp;</span></p>
+<p id='t83' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;username&#39;</span> <span class='key'>in</span> <span class='nam'>_credentials</span><span class='op'>)</span> <span class='key'>and</span> <span class='op'>(</span><span class='str'>&#39;api_key&#39;</span> <span class='key'>in</span> <span class='nam'>_credentials</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t84' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>copy</span><span class='op'>.</span><span class='nam'>copy</span><span class='op'>(</span><span class='nam'>_credentials</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t85' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t86' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_credentials_file</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t87' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t88' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t89' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>iplot</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t90' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Create a unique url for this plot in Plotly and open in IPython.</span><span class='strut'>&nbsp;</span></p>
-<p id='t91' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t92' class='pln'><span class='str'>&nbsp; &nbsp; plot_options keyword agruments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t93' class='pln'><span class='str'>&nbsp; &nbsp; filename (string) -- the name that will be associated with this figure</span><span class='strut'>&nbsp;</span></p>
-<p id='t94' class='pln'><span class='str'>&nbsp; &nbsp; fileopt (&#39;new&#39; | &#39;overwrite&#39; | &#39;extend&#39; | &#39;append&#39;) -- &#39;new&#39; creates a</span><span class='strut'>&nbsp;</span></p>
-<p id='t95' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;new&#39;: create a new, unique url for this plot</span><span class='strut'>&nbsp;</span></p>
-<p id='t96' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;overwrite&#39;: overwrite the file associated with `filename` with this</span><span class='strut'>&nbsp;</span></p>
-<p id='t97' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;extend&#39;: add additional numbers (data) to existing traces</span><span class='strut'>&nbsp;</span></p>
-<p id='t98' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;append&#39;: add additional traces to existing data lists</span><span class='strut'>&nbsp;</span></p>
-<p id='t99' class='pln'><span class='str'>&nbsp; &nbsp; world_readable (default=True) -- make this figure private/public</span><span class='strut'>&nbsp;</span></p>
-<p id='t100' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t101' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t102' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;auto_open&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>plot_options</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t103' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;auto_open&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>False</span><span class='strut'>&nbsp;</span></p>
-<p id='t104' class='stm mis'>&nbsp; &nbsp; <span class='nam'>res</span> <span class='op'>=</span> <span class='nam'>plot</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t105' class='stm mis'>&nbsp; &nbsp; <span class='nam'>urlsplit</span> <span class='op'>=</span> <span class='nam'>res</span><span class='op'>.</span><span class='nam'>split</span><span class='op'>(</span><span class='str'>&#39;/&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t106' class='stm mis'>&nbsp; &nbsp; <span class='nam'>username</span><span class='op'>,</span> <span class='nam'>plot_id</span> <span class='op'>=</span> <span class='nam'>urlsplit</span><span class='op'>[</span><span class='op'>-</span><span class='num'>2</span><span class='op'>]</span><span class='op'>[</span><span class='num'>1</span><span class='op'>:</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>urlsplit</span><span class='op'>[</span><span class='op'>-</span><span class='num'>1</span><span class='op'>]</span>&nbsp; <span class='com'># TODO: HACKY!</span><span class='strut'>&nbsp;</span></p>
-<p id='t107' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t108' class='stm mis'>&nbsp; &nbsp; <span class='nam'>embed_options</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t109' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;width&#39;</span> <span class='key'>in</span> <span class='nam'>plot_options</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t110' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>embed_options</span><span class='op'>[</span><span class='str'>&#39;width&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;width&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t111' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;height&#39;</span> <span class='key'>in</span> <span class='nam'>plot_options</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t112' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>embed_options</span><span class='op'>[</span><span class='str'>&#39;height&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;height&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t113' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t114' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>embed</span><span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>plot_id</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>embed_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t89' class='pln'><span class='com'>### plot stuff ###</span><span class='strut'>&nbsp;</span></p>
+<p id='t90' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t91' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>iplot</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t92' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Create a unique url for this plot in Plotly and open in IPython.</span><span class='strut'>&nbsp;</span></p>
+<p id='t93' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t94' class='pln'><span class='str'>&nbsp; &nbsp; plot_options keyword agruments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t95' class='pln'><span class='str'>&nbsp; &nbsp; filename (string) -- the name that will be associated with this figure</span><span class='strut'>&nbsp;</span></p>
+<p id='t96' class='pln'><span class='str'>&nbsp; &nbsp; fileopt (&#39;new&#39; | &#39;overwrite&#39; | &#39;extend&#39; | &#39;append&#39;) -- &#39;new&#39; creates a</span><span class='strut'>&nbsp;</span></p>
+<p id='t97' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;new&#39;: create a new, unique url for this plot</span><span class='strut'>&nbsp;</span></p>
+<p id='t98' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;overwrite&#39;: overwrite the file associated with `filename` with this</span><span class='strut'>&nbsp;</span></p>
+<p id='t99' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;extend&#39;: add additional numbers (data) to existing traces</span><span class='strut'>&nbsp;</span></p>
+<p id='t100' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;append&#39;: add additional traces to existing data lists</span><span class='strut'>&nbsp;</span></p>
+<p id='t101' class='pln'><span class='str'>&nbsp; &nbsp; world_readable (default=True) -- make this figure private/public</span><span class='strut'>&nbsp;</span></p>
+<p id='t102' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t103' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t104' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;auto_open&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>plot_options</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t105' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;auto_open&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>False</span><span class='strut'>&nbsp;</span></p>
+<p id='t106' class='stm mis'>&nbsp; &nbsp; <span class='nam'>res</span> <span class='op'>=</span> <span class='nam'>plot</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t107' class='stm mis'>&nbsp; &nbsp; <span class='nam'>urlsplit</span> <span class='op'>=</span> <span class='nam'>res</span><span class='op'>.</span><span class='nam'>split</span><span class='op'>(</span><span class='str'>&#39;/&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t108' class='stm mis'>&nbsp; &nbsp; <span class='nam'>username</span><span class='op'>,</span> <span class='nam'>plot_id</span> <span class='op'>=</span> <span class='nam'>urlsplit</span><span class='op'>[</span><span class='op'>-</span><span class='num'>2</span><span class='op'>]</span><span class='op'>[</span><span class='num'>1</span><span class='op'>:</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>urlsplit</span><span class='op'>[</span><span class='op'>-</span><span class='num'>1</span><span class='op'>]</span>&nbsp; <span class='com'># TODO: HACKY!</span><span class='strut'>&nbsp;</span></p>
+<p id='t109' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t110' class='stm mis'>&nbsp; &nbsp; <span class='nam'>embed_options</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t111' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;width&#39;</span> <span class='key'>in</span> <span class='nam'>plot_options</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t112' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>embed_options</span><span class='op'>[</span><span class='str'>&#39;width&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;width&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t113' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;height&#39;</span> <span class='key'>in</span> <span class='nam'>plot_options</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t114' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>embed_options</span><span class='op'>[</span><span class='str'>&#39;height&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;height&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
 <p id='t115' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t116' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t117' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>_plot_option_logic</span><span class='op'>(</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t118' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Sets plot_options via a precedence hierarchy.&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t119' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>options</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t120' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>options</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>_DEFAULT_PLOT_OPTIONS</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t121' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>options</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>_plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t122' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>options</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t123' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;filename&#39;</span> <span class='key'>in</span> <span class='nam'>plot_options</span><span class='strut'>&nbsp;</span></p>
-<p id='t124' class='pln'>&nbsp; &nbsp; &nbsp;&nbsp; <span class='key'>and</span> <span class='str'>&#39;fileopt&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>_plot_options</span><span class='strut'>&nbsp;</span></p>
-<p id='t125' class='pln'>&nbsp; &nbsp; &nbsp;&nbsp; <span class='key'>and</span> <span class='str'>&#39;fileopt&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t126' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>options</span><span class='op'>[</span><span class='str'>&#39;fileopt&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='str'>&#39;overwrite&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t127' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>options</span><span class='strut'>&nbsp;</span></p>
-<p id='t128' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t129' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t130' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>plot</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>validate</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t131' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Create a unique url for this plot in Plotly and optionally open url.</span><span class='strut'>&nbsp;</span></p>
-<p id='t132' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t133' class='pln'><span class='str'>&nbsp; &nbsp; plot_options keyword agruments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t134' class='pln'><span class='str'>&nbsp; &nbsp; filename (string) -- the name that will be associated with this figure</span><span class='strut'>&nbsp;</span></p>
-<p id='t135' class='pln'><span class='str'>&nbsp; &nbsp; fileopt (&#39;new&#39; | &#39;overwrite&#39; | &#39;extend&#39; | &#39;append&#39;) -- &#39;new&#39; creates a</span><span class='strut'>&nbsp;</span></p>
-<p id='t136' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;new&#39;: create a new, unique url for this plot</span><span class='strut'>&nbsp;</span></p>
-<p id='t137' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;overwrite&#39;: overwrite the file associated with `filename` with this</span><span class='strut'>&nbsp;</span></p>
-<p id='t138' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;extend&#39;: add additional numbers (data) to existing traces</span><span class='strut'>&nbsp;</span></p>
-<p id='t139' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;append&#39;: add additional traces to existing data lists</span><span class='strut'>&nbsp;</span></p>
-<p id='t140' class='pln'><span class='str'>&nbsp; &nbsp; world_readable (default=True) -- make this figure private/public</span><span class='strut'>&nbsp;</span></p>
-<p id='t141' class='pln'><span class='str'>&nbsp; &nbsp; auto_open (default=True) -- Toggle browser options</span><span class='strut'>&nbsp;</span></p>
-<p id='t142' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; True: open this plot in a new browser tab</span><span class='strut'>&nbsp;</span></p>
-<p id='t143' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; False: do not open plot in the browser, but do return the unique url</span><span class='strut'>&nbsp;</span></p>
-<p id='t144' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t145' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t146' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t147' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>figure</span> <span class='op'>=</span> <span class='nam'>figure_or_data</span><span class='strut'>&nbsp;</span></p>
-<p id='t148' class='stm mis'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t149' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>figure</span> <span class='op'>=</span> <span class='op'>{</span><span class='str'>&#39;data&#39;</span><span class='op'>:</span> <span class='nam'>figure_or_data</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
-<p id='t150' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t151' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;The `figure_or_data` positional argument &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t152' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;must be either `dict`-like or &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t153' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;`list`-like.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t154' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>validate</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t155' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t156' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='nam'>figure</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='op'>=</span><span class='str'>&#39;Figure&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t157' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t158' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;Invalid &#39;figure_or_data&#39; argument. &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t159' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Plotly will not be able to properly &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t160' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;parse the resulting JSON. If you &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t161' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;want to send this &#39;figure_or_data&#39; &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t162' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;to Plotly anyway (not recommended), &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t163' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;you can set &#39;validate=False&#39; as a &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t164' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;plot option.\nHere&#39;s why you&#39;re &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t165' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;seeing this error:\n\n{}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>err</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t166' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>figure</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t167' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t168' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t169' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>)</span> <span class='op'>&gt;</span> <span class='num'>40000</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t170' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>msg</span> <span class='op'>=</span> <span class='op'>(</span><span class='str'>&quot;Woah there! Look at all those points! Due to &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t171' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;browser limitations, Plotly has a hard time &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t172' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;graphing more than 500k data points for line &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t173' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;charts, or 40k points for other types of charts. &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t174' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Here are some suggestions:\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t175' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;(1) Trying using the image API to return an image &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t176' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;instead of a graph URL\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t177' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;(2) Use matplotlib\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t178' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;(3) See if you can create your visualization with &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t179' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;fewer data points\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t180' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;If the visualization you&#39;re using aggregates &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t181' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;points (e.g., box plot, histogram, etc.) you can &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t182' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;disregard this warning.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t183' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='nam'>msg</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t184' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>TypeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t185' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t186' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>plot_options</span> <span class='op'>=</span> <span class='nam'>_plot_option_logic</span><span class='op'>(</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t187' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>res</span> <span class='op'>=</span> <span class='nam'>_send_to_plotly</span><span class='op'>(</span><span class='nam'>figure</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t188' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>res</span><span class='op'>[</span><span class='str'>&#39;error&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t189' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;auto_open&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t190' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t191' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>from</span> <span class='nam'>webbrowser</span> <span class='key'>import</span> <span class='nam'>open</span> <span class='key'>as</span> <span class='nam'>wbopen</span><span class='strut'>&nbsp;</span></p>
-<p id='t192' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>wbopen</span><span class='op'>(</span><span class='nam'>res</span><span class='op'>[</span><span class='str'>&#39;url&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t193' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: what should we except here? this is dangerous</span><span class='strut'>&nbsp;</span></p>
-<p id='t194' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t195' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>res</span><span class='op'>[</span><span class='str'>&#39;url&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t196' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t197' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyAccountError</span><span class='op'>(</span><span class='nam'>res</span><span class='op'>[</span><span class='str'>&#39;error&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t198' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t199' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t200' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>iplot_mpl</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='nam'>resize</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='nam'>strip_style</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span> <span class='nam'>update</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t201' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Replot a matplotlib figure with plotly in IPython.</span><span class='strut'>&nbsp;</span></p>
-<p id='t202' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t203' class='pln'><span class='str'>&nbsp; &nbsp; This function:</span><span class='strut'>&nbsp;</span></p>
-<p id='t204' class='pln'><span class='str'>&nbsp; &nbsp; 1. converts the mpl figure into JSON (run help(plolty.tools.mpl_to_plotly))</span><span class='strut'>&nbsp;</span></p>
-<p id='t205' class='pln'><span class='str'>&nbsp; &nbsp; 2. makes a request to Plotly to save this figure in your account</span><span class='strut'>&nbsp;</span></p>
-<p id='t206' class='pln'><span class='str'>&nbsp; &nbsp; 3. displays the image in your IPython output cell</span><span class='strut'>&nbsp;</span></p>
-<p id='t207' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t208' class='pln'><span class='str'>&nbsp; &nbsp; Positional agruments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t209' class='pln'><span class='str'>&nbsp; &nbsp; fig -- a figure object from matplotlib</span><span class='strut'>&nbsp;</span></p>
-<p id='t210' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t211' class='pln'><span class='str'>&nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t212' class='pln'><span class='str'>&nbsp; &nbsp; resize (default=True) -- allow plotly to choose the figure size</span><span class='strut'>&nbsp;</span></p>
-<p id='t213' class='pln'><span class='str'>&nbsp; &nbsp; strip_style (default=False) -- allow plotly to choose style options</span><span class='strut'>&nbsp;</span></p>
-<p id='t214' class='pln'><span class='str'>&nbsp; &nbsp; update (default=None) -- update the resulting figure with an &#39;update&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t215' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; dictionary-like object resembling a plotly &#39;Figure&#39; object</span><span class='strut'>&nbsp;</span></p>
-<p id='t216' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t217' class='pln'><span class='str'>&nbsp; &nbsp; Additional keyword arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t218' class='pln'><span class='str'>&nbsp; &nbsp; plot_options -- run help(plotly.plotly.iplot)</span><span class='strut'>&nbsp;</span></p>
-<p id='t219' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t220' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t221' class='stm mis'>&nbsp; &nbsp; <span class='nam'>fig</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>mpl_to_plotly</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='nam'>resize</span><span class='op'>=</span><span class='nam'>resize</span><span class='op'>,</span> <span class='nam'>strip_style</span><span class='op'>=</span><span class='nam'>strip_style</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t222' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>update</span> <span class='key'>and</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>update</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t223' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t224' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>fig</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>update</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t225' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>fig</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t226' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t227' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_note</span><span class='op'>(</span><span class='str'>&quot;Your updated figure could not be properly validated.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t228' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t229' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
-<p id='t230' class='stm mis'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>update</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t231' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t232' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;update&#39; must be dictionary-like and a valid plotly Figure &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t233' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;object. Run &#39;help(plotly.graph_objs.Figure)&#39; for more info.&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t234' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t235' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>iplot</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t236' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t237' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t238' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>plot_mpl</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='nam'>resize</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='nam'>strip_style</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span> <span class='nam'>update</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t239' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Replot a matplotlib figure with plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t240' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t241' class='pln'><span class='str'>&nbsp; &nbsp; This function:</span><span class='strut'>&nbsp;</span></p>
-<p id='t242' class='pln'><span class='str'>&nbsp; &nbsp; 1. converts the mpl figure into JSON (run help(plolty.tools.mpl_to_plotly))</span><span class='strut'>&nbsp;</span></p>
-<p id='t243' class='pln'><span class='str'>&nbsp; &nbsp; 2. makes a request to Plotly to save this figure in your account</span><span class='strut'>&nbsp;</span></p>
-<p id='t244' class='pln'><span class='str'>&nbsp; &nbsp; 3. opens your figure in a browser tab OR returns the unique figure url</span><span class='strut'>&nbsp;</span></p>
-<p id='t245' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t246' class='pln'><span class='str'>&nbsp; &nbsp; Positional agruments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t247' class='pln'><span class='str'>&nbsp; &nbsp; fig -- a figure object from matplotlib</span><span class='strut'>&nbsp;</span></p>
-<p id='t248' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t249' class='pln'><span class='str'>&nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t250' class='pln'><span class='str'>&nbsp; &nbsp; resize (default=True) -- allow plotly to choose the figure size</span><span class='strut'>&nbsp;</span></p>
-<p id='t251' class='pln'><span class='str'>&nbsp; &nbsp; strip_style (default=False) -- allow plotly to choose style options</span><span class='strut'>&nbsp;</span></p>
-<p id='t252' class='pln'><span class='str'>&nbsp; &nbsp; update (default=None) -- update the resulting figure with an &#39;update&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t253' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; dictionary-like object resembling a plotly &#39;Figure&#39; object</span><span class='strut'>&nbsp;</span></p>
-<p id='t254' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t255' class='pln'><span class='str'>&nbsp; &nbsp; Additional keyword arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t256' class='pln'><span class='str'>&nbsp; &nbsp; plot_options -- run help(plotly.plotly.plot)</span><span class='strut'>&nbsp;</span></p>
-<p id='t257' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t258' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t259' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>fig</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>mpl_to_plotly</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='nam'>resize</span><span class='op'>=</span><span class='nam'>resize</span><span class='op'>,</span> <span class='nam'>strip_style</span><span class='op'>=</span><span class='nam'>strip_style</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t260' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>update</span> <span class='key'>and</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>update</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t261' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t262' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>fig</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>update</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t263' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>fig</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t264' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t265' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_note</span><span class='op'>(</span><span class='str'>&quot;Your updated figure could not be properly validated.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t266' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t267' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
-<p id='t268' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>update</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t269' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t270' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;update&#39; must be dictionary-like and a valid plotly Figure &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t271' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;object. Run &#39;help(plotly.graph_objs.Figure)&#39; for more info.&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t272' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t273' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>plot</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t274' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t275' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t276' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_figure</span><span class='op'>(</span><span class='nam'>file_owner_or_url</span><span class='op'>,</span> <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>raw</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t277' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns a JSON figure representation for the specified file</span><span class='strut'>&nbsp;</span></p>
-<p id='t278' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t279' class='pln'><span class='str'>&nbsp; &nbsp; Plotly uniquely identifies figures with a &#39;file_owner&#39;/&#39;file_id&#39; pair.</span><span class='strut'>&nbsp;</span></p>
-<p id='t280' class='pln'><span class='str'>&nbsp; &nbsp; Since each file is given a corresponding unique url, you may also simply</span><span class='strut'>&nbsp;</span></p>
-<p id='t281' class='pln'><span class='str'>&nbsp; &nbsp; pass a valid plotly url as the first argument.</span><span class='strut'>&nbsp;</span></p>
-<p id='t282' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t283' class='pln'><span class='str'>&nbsp; &nbsp; Note, if you&#39;re using a file_owner string as the first argument, you MUST</span><span class='strut'>&nbsp;</span></p>
-<p id='t284' class='pln'><span class='str'>&nbsp; &nbsp; specify a `file_id` keyword argument. Else, if you&#39;re using a url string</span><span class='strut'>&nbsp;</span></p>
-<p id='t285' class='pln'><span class='str'>&nbsp; &nbsp; as the first argument, you MUST NOT specify a `file_id` keyword argument, or</span><span class='strut'>&nbsp;</span></p>
-<p id='t286' class='pln'><span class='str'>&nbsp; &nbsp; file_id must be set to Python&#39;s None value.</span><span class='strut'>&nbsp;</span></p>
-<p id='t287' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t288' class='pln'><span class='str'>&nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t289' class='pln'><span class='str'>&nbsp; &nbsp; file_owner_or_url (string) -- a valid plotly username OR a valid plotly url</span><span class='strut'>&nbsp;</span></p>
-<p id='t290' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t291' class='pln'><span class='str'>&nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t292' class='pln'><span class='str'>&nbsp; &nbsp; file_id (default=None) -- an int or string that can be converted to int</span><span class='strut'>&nbsp;</span></p>
-<p id='t293' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; if you&#39;re using a url, don&#39;t fill this in!</span><span class='strut'>&nbsp;</span></p>
-<p id='t294' class='pln'><span class='str'>&nbsp; &nbsp; raw (default=False) -- if true, return unicode JSON string verbatim**</span><span class='strut'>&nbsp;</span></p>
-<p id='t295' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t296' class='pln'><span class='str'>&nbsp; &nbsp; **by default, plotly will return a Figure object (run help(plotly</span><span class='strut'>&nbsp;</span></p>
-<p id='t297' class='pln'><span class='str'>&nbsp; &nbsp; .graph_objs.Figure)). This representation decodes the keys and values from</span><span class='strut'>&nbsp;</span></p>
-<p id='t298' class='pln'><span class='str'>&nbsp; &nbsp; unicode (if possible), removes information irrelevant to the figure</span><span class='strut'>&nbsp;</span></p>
-<p id='t299' class='pln'><span class='str'>&nbsp; &nbsp; representation, and converts the JSON dictionary objects to plotly</span><span class='strut'>&nbsp;</span></p>
-<p id='t300' class='pln'><span class='str'>&nbsp; &nbsp; `graph objects`.</span><span class='strut'>&nbsp;</span></p>
-<p id='t301' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t302' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t303' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>plotly_rest_url</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>[</span><span class='str'>&#39;plotly_domain&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t304' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>file_id</span> <span class='key'>is</span> <span class='nam'>None</span><span class='op'>:</span>&nbsp; <span class='com'># assume we&#39;re using a url</span><span class='strut'>&nbsp;</span></p>
-<p id='t305' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>url</span> <span class='op'>=</span> <span class='nam'>file_owner_or_url</span><span class='strut'>&nbsp;</span></p>
-<p id='t306' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>url</span><span class='op'>[</span><span class='op'>:</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>plotly_rest_url</span><span class='op'>)</span><span class='op'>]</span> <span class='op'>!=</span> <span class='nam'>plotly_rest_url</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t307' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t308' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Because you didn&#39;t supply a &#39;file_id&#39; in the call, &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t309' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;we&#39;re assuming you&#39;re trying to snag a figure from a url. &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t310' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;You supplied the url, &#39;{}&#39;, we expected it to start with &#39;{}&#39;.&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t311' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;\nRun help on this function for more information.&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t312' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>url</span><span class='op'>,</span> <span class='nam'>plotly_rest_url</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t313' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>head</span> <span class='op'>=</span> <span class='nam'>plotly_rest_url</span> <span class='op'>+</span> <span class='str'>&quot;/~&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t314' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_owner</span> <span class='op'>=</span> <span class='nam'>url</span><span class='op'>.</span><span class='nam'>replace</span><span class='op'>(</span><span class='nam'>head</span><span class='op'>,</span> <span class='str'>&quot;&quot;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>split</span><span class='op'>(</span><span class='str'>&#39;/&#39;</span><span class='op'>)</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t315' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_id</span> <span class='op'>=</span> <span class='nam'>url</span><span class='op'>.</span><span class='nam'>replace</span><span class='op'>(</span><span class='nam'>head</span><span class='op'>,</span> <span class='str'>&quot;&quot;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>split</span><span class='op'>(</span><span class='str'>&#39;/&#39;</span><span class='op'>)</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t316' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t317' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_owner</span> <span class='op'>=</span> <span class='nam'>file_owner_or_url</span><span class='strut'>&nbsp;</span></p>
-<p id='t318' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>resource</span> <span class='op'>=</span> <span class='str'>&quot;/apigetfile/{username}/{file_id}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>username</span><span class='op'>=</span><span class='nam'>file_owner</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t319' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>file_id</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t320' class='stm run hide_run'>&nbsp; &nbsp; <span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='op'>)</span> <span class='op'>=</span> <span class='nam'>_validation_key_logic</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t321' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>headers</span> <span class='op'>=</span> <span class='op'>{</span><span class='str'>&#39;plotly-username&#39;</span><span class='op'>:</span> <span class='nam'>username</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t322' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly-apikey&#39;</span><span class='op'>:</span> <span class='nam'>api_key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t323' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly-version&#39;</span><span class='op'>:</span> <span class='nam'>version</span><span class='op'>.</span><span class='nam'>__version__</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t324' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly-platform&#39;</span><span class='op'>:</span> <span class='str'>&#39;python&#39;</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
-<p id='t325' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t326' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>test_if_int</span> <span class='op'>=</span> <span class='nam'>int</span><span class='op'>(</span><span class='nam'>file_id</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t327' class='stm mis'>&nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>ValueError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t328' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t329' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The &#39;file_id&#39; argument was not able to be converted into an &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t330' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;integer number. Make sure that the positional &#39;file_id&#39; argument &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t331' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;is a number that can be converted into an integer or a string &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t332' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;that can be converted into an integer.&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t333' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t334' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>int</span><span class='op'>(</span><span class='nam'>file_id</span><span class='op'>)</span> <span class='op'>&lt;</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t335' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t336' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The &#39;file_id&#39; argument must be a non-negative number.&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t337' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t338' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>response</span> <span class='op'>=</span> <span class='nam'>requests</span><span class='op'>.</span><span class='nam'>get</span><span class='op'>(</span><span class='nam'>plotly_rest_url</span> <span class='op'>+</span> <span class='nam'>resource</span><span class='op'>,</span> <span class='nam'>headers</span><span class='op'>=</span><span class='nam'>headers</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t339' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>response</span><span class='op'>.</span><span class='nam'>status_code</span> <span class='op'>==</span> <span class='num'>200</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t340' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>six</span><span class='op'>.</span><span class='nam'>PY3</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t341' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>content</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>response</span><span class='op'>.</span><span class='nam'>content</span><span class='op'>.</span><span class='nam'>decode</span><span class='op'>(</span><span class='str'>&#39;unicode_escape&#39;</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t342' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t343' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>content</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>response</span><span class='op'>.</span><span class='nam'>content</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t344' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>response_payload</span> <span class='op'>=</span> <span class='nam'>content</span><span class='op'>[</span><span class='str'>&#39;payload&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t345' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>figure</span> <span class='op'>=</span> <span class='nam'>response_payload</span><span class='op'>[</span><span class='str'>&#39;figure&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t346' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>decode_unicode</span><span class='op'>(</span><span class='nam'>figure</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t347' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>raw</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t348' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>figure</span><span class='strut'>&nbsp;</span></p>
-<p id='t349' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t350' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_valid_graph_obj</span><span class='op'>(</span><span class='nam'>figure</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='op'>=</span><span class='str'>&#39;Figure&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t351' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t352' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t353' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>content</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>response</span><span class='op'>.</span><span class='nam'>content</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t354' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='nam'>content</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t355' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t356' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t357' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;There was an error retrieving this file&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t358' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t359' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t360' class='stm run hide_run'><span class='op'>@</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>template_doc</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t361' class='pln'><span class='key'>class</span> <span class='nam'>Stream</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t362' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Interface to Plotly&#39;s real-time graphing API.</span><span class='strut'>&nbsp;</span></p>
-<p id='t363' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t364' class='pln'><span class='str'>&nbsp; &nbsp; Initialize a Stream object with a stream_id</span><span class='strut'>&nbsp;</span></p>
-<p id='t365' class='pln'><span class='str'>&nbsp; &nbsp; found in {plotly_domain}/settings.</span><span class='strut'>&nbsp;</span></p>
-<p id='t366' class='pln'><span class='str'>&nbsp; &nbsp; Real-time graphs are initialized with a call to `plot` that embeds</span><span class='strut'>&nbsp;</span></p>
-<p id='t367' class='pln'><span class='str'>&nbsp; &nbsp; your unique `stream_id`s in each of the graph&#39;s traces. The `Stream`</span><span class='strut'>&nbsp;</span></p>
-<p id='t368' class='pln'><span class='str'>&nbsp; &nbsp; interface plots data to these traces, as identified with the unique</span><span class='strut'>&nbsp;</span></p>
-<p id='t369' class='pln'><span class='str'>&nbsp; &nbsp; stream_id, in real-time.</span><span class='strut'>&nbsp;</span></p>
-<p id='t370' class='pln'><span class='str'>&nbsp; &nbsp; Every viewer of the graph sees the same data at the same time.</span><span class='strut'>&nbsp;</span></p>
-<p id='t371' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t372' class='pln'><span class='str'>&nbsp; &nbsp; View examples and tutorials here:</span><span class='strut'>&nbsp;</span></p>
-<p id='t373' class='pln'><span class='str'>&nbsp; &nbsp; http://nbviewer.ipython.org/github/plotly/python-user-guide/blob/master/s7_streaming/s7_streaming.ipynb</span><span class='strut'>&nbsp;</span></p>
-<p id='t374' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t375' class='pln'><span class='str'>&nbsp; &nbsp; Stream example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t376' class='pln'><span class='str'>&nbsp; &nbsp; # Initialize a streaming graph</span><span class='strut'>&nbsp;</span></p>
-<p id='t377' class='pln'><span class='str'>&nbsp; &nbsp; # by embedding stream_id&#39;s in the graph&#39;s traces</span><span class='strut'>&nbsp;</span></p>
-<p id='t378' class='pln'><span class='str'>&nbsp; &nbsp; &gt;&gt;&gt; stream_id = &quot;your_stream_id&quot; # See {plotly_domain}/settings</span><span class='strut'>&nbsp;</span></p>
-<p id='t379' class='pln'><span class='str'>&nbsp; &nbsp; &gt;&gt;&gt; py.plot(Data([Scatter(x=[],</span><span class='strut'>&nbsp;</span></p>
-<p id='t380' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; y=[],</span><span class='strut'>&nbsp;</span></p>
-<p id='t381' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; stream=dict(token=stream_id, maxpoints=100))])</span><span class='strut'>&nbsp;</span></p>
-<p id='t382' class='pln'><span class='str'>&nbsp; &nbsp; # Stream data to the import trace</span><span class='strut'>&nbsp;</span></p>
-<p id='t383' class='pln'><span class='str'>&nbsp; &nbsp; &gt;&gt;&gt; stream = Stream(stream_id) # Initialize a stream object</span><span class='strut'>&nbsp;</span></p>
-<p id='t384' class='pln'><span class='str'>&nbsp; &nbsp; &gt;&gt;&gt; stream.open() # Open the stream</span><span class='strut'>&nbsp;</span></p>
-<p id='t385' class='pln'><span class='str'>&nbsp; &nbsp; &gt;&gt;&gt; stream.write(dict(x=1, y=1)) # Plot (1, 1) in your graph</span><span class='strut'>&nbsp;</span></p>
-<p id='t386' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t387' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t388' class='stm run hide_run'>&nbsp; &nbsp; <span class='op'>@</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>template_doc</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t389' class='pln'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>stream_id</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t390' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Initialize a Stream object with your unique stream_id.</span><span class='strut'>&nbsp;</span></p>
-<p id='t391' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Find your stream_id at {plotly_domain}/settings.</span><span class='strut'>&nbsp;</span></p>
-<p id='t392' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t393' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; For more help, see: `help(plotly.plotly.Stream)`</span><span class='strut'>&nbsp;</span></p>
-<p id='t394' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; or see examples and tutorials here:</span><span class='strut'>&nbsp;</span></p>
-<p id='t395' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; http://nbviewer.ipython.org/github/plotly/python-user-guide/blob/master/s7_streaming/s7_streaming.ipynb</span><span class='strut'>&nbsp;</span></p>
-<p id='t396' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t397' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>stream_id</span> <span class='op'>=</span> <span class='nam'>stream_id</span><span class='strut'>&nbsp;</span></p>
-<p id='t398' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>connected</span> <span class='op'>=</span> <span class='nam'>False</span><span class='strut'>&nbsp;</span></p>
-<p id='t399' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t400' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>open</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t401' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Open streaming connection to plotly.</span><span class='strut'>&nbsp;</span></p>
-<p id='t402' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t403' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; For more help, see: `help(plotly.plotly.Stream)`</span><span class='strut'>&nbsp;</span></p>
-<p id='t404' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; or see examples and tutorials here:</span><span class='strut'>&nbsp;</span></p>
-<p id='t405' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; http://nbviewer.ipython.org/github/plotly/python-user-guide/blob/master/s7_streaming/s7_streaming.ipynb</span><span class='strut'>&nbsp;</span></p>
-<p id='t406' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t407' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t408' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>streaming_url</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>[</span><span class='str'>&#39;plotly_streaming_domain&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t409' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>_stream</span> <span class='op'>=</span> <span class='nam'>chunked_requests</span><span class='op'>.</span><span class='nam'>Stream</span><span class='op'>(</span><span class='nam'>streaming_url</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t410' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='num'>80</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t411' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='op'>{</span><span class='str'>&#39;Host&#39;</span><span class='op'>:</span> <span class='nam'>streaming_url</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t412' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;plotly-streamtoken&#39;</span><span class='op'>:</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>stream_id</span><span class='op'>}</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t413' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t414' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>write</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>trace</span><span class='op'>,</span> <span class='nam'>layout</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>validate</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t415' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>reconnect_on</span><span class='op'>=</span><span class='op'>(</span><span class='num'>200</span><span class='op'>,</span> <span class='str'>&#39;&#39;</span><span class='op'>,</span> <span class='num'>408</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t416' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Write to an open stream.</span><span class='strut'>&nbsp;</span></p>
-<p id='t417' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t418' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Once you&#39;ve instantiated a &#39;Stream&#39; object with a &#39;stream_id&#39;,</span><span class='strut'>&nbsp;</span></p>
-<p id='t419' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; you can &#39;write&#39; to it in real time.</span><span class='strut'>&nbsp;</span></p>
-<p id='t420' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t421' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; positional arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t422' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; trace - A valid plotly trace object (e.g., Scatter, Heatmap, etc.).</span><span class='strut'>&nbsp;</span></p>
-<p id='t423' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Not all keys in these are `stremable` run help(Obj) on the type</span><span class='strut'>&nbsp;</span></p>
-<p id='t424' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; of trace your trying to stream, for each valid key, if the key</span><span class='strut'>&nbsp;</span></p>
-<p id='t425' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; is streamable, it will say &#39;streamable = True&#39;. Trace objects</span><span class='strut'>&nbsp;</span></p>
-<p id='t426' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; must be dictionary-like.</span><span class='strut'>&nbsp;</span></p>
-<p id='t427' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t428' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; keyword arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t429' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; layout (default=None) - A valid Layout object</span><span class='strut'>&nbsp;</span></p>
-<p id='t430' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Run help(plotly.graph_objs.Layout)</span><span class='strut'>&nbsp;</span></p>
-<p id='t431' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; validate (default = True) - Validate this stream before sending?</span><span class='strut'>&nbsp;</span></p>
-<p id='t432' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; This will catch local errors if set to True.</span><span class='strut'>&nbsp;</span></p>
-<p id='t433' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t434' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Some valid keys for trace dictionaries:</span><span class='strut'>&nbsp;</span></p>
-<p id='t435' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;x&#39;, &#39;y&#39;, &#39;text&#39;, &#39;z&#39;, &#39;marker&#39;, &#39;line&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t436' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t437' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Examples:</span><span class='strut'>&nbsp;</span></p>
-<p id='t438' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &gt;&gt;&gt; write(dict(x=1, y=2))&nbsp; # assumes &#39;scatter&#39; type</span><span class='strut'>&nbsp;</span></p>
-<p id='t439' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &gt;&gt;&gt; write(Bar(x=[1, 2, 3], y=[10, 20, 30]))</span><span class='strut'>&nbsp;</span></p>
-<p id='t440' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &gt;&gt;&gt; write(Scatter(x=1, y=2, text=&#39;scatter text&#39;))</span><span class='strut'>&nbsp;</span></p>
-<p id='t441' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &gt;&gt;&gt; write(Scatter(x=1, y=3, marker=Marker(color=&#39;blue&#39;)))</span><span class='strut'>&nbsp;</span></p>
-<p id='t442' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &gt;&gt;&gt; write(Heatmap(z=[[1, 2, 3], [4, 5, 6]]))</span><span class='strut'>&nbsp;</span></p>
-<p id='t443' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t444' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The connection to plotly&#39;s servers is checked before writing</span><span class='strut'>&nbsp;</span></p>
-<p id='t445' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; and reconnected if disconnected and if the response status code</span><span class='strut'>&nbsp;</span></p>
-<p id='t446' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; is in `reconnect_on`.</span><span class='strut'>&nbsp;</span></p>
-<p id='t447' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t448' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; For more help, see: `help(plotly.plotly.Stream)`</span><span class='strut'>&nbsp;</span></p>
-<p id='t449' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; or see examples and tutorials here:</span><span class='strut'>&nbsp;</span></p>
-<p id='t450' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; http://nbviewer.ipython.org/github/plotly/python-user-guide/blob/master/s7_streaming/s7_streaming.ipynb</span><span class='strut'>&nbsp;</span></p>
-<p id='t451' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t452' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>stream_object</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t453' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>stream_object</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>trace</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t454' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;type&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>stream_object</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t455' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>stream_object</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='str'>&#39;scatter&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t456' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>validate</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t457' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t458' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='nam'>stream_object</span><span class='op'>,</span> <span class='nam'>stream_object</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t459' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t460' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t461' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Part of the data object with type, &#39;{}&#39;, is invalid. This &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t462' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;will default to &#39;scatter&#39; if you do not supply a &#39;type&#39;. &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t463' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;If you do not want to validate your data objects when &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t464' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;streaming, you can set &#39;validate=False&#39; in the call to &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t465' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;your_stream.write()&#39;. Here&#39;s why the object is &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t466' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;invalid:\n\n{}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>stream_object</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>err</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t467' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t468' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t469' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>validate_stream</span><span class='op'>(</span><span class='nam'>stream_object</span><span class='op'>,</span> <span class='nam'>stream_object</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t470' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t471' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t472' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Part of the data object with type, &#39;{}&#39;, cannot yet be &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t473' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;streamed into Plotly. If you do not want to validate your &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t474' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;data objects when streaming, you can set &#39;validate=False&#39; &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t475' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;in the call to &#39;your_stream.write()&#39;. Here&#39;s why the &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t476' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;object cannot be streamed:\n\n{}&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t477' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>stream_object</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>err</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t478' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t479' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>layout</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t480' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t481' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='nam'>layout</span><span class='op'>,</span> <span class='str'>&#39;Layout&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t482' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t483' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t484' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Your layout kwarg was invalid. &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t485' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Here&#39;s why:\n\n{}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>err</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t486' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t487' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>stream_object</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t488' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t489' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>layout</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t490' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>stream_object</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>dict</span><span class='op'>(</span><span class='nam'>layout</span><span class='op'>=</span><span class='nam'>layout</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t491' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t492' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># TODO: allow string version of this?</span><span class='strut'>&nbsp;</span></p>
-<p id='t493' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>jdata</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>dumps</span><span class='op'>(</span><span class='nam'>stream_object</span><span class='op'>,</span> <span class='nam'>cls</span><span class='op'>=</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>_plotlyJSONEncoder</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t494' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>jdata</span> <span class='op'>+=</span> <span class='str'>&quot;\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t495' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t496' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t497' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>_stream</span><span class='op'>.</span><span class='nam'>write</span><span class='op'>(</span><span class='nam'>jdata</span><span class='op'>,</span> <span class='nam'>reconnect_on</span><span class='op'>=</span><span class='nam'>reconnect_on</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t498' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t499' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;Stream has not been opened yet, &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t500' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;cannot write to a closed connection. &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t501' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Call `open()` on the stream to open the stream.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t502' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t503' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>close</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t504' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Close the stream connection to plotly&#39;s streaming servers.</span><span class='strut'>&nbsp;</span></p>
-<p id='t505' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t506' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; For more help, see: `help(plotly.plotly.Stream)`</span><span class='strut'>&nbsp;</span></p>
-<p id='t507' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; or see examples and tutorials here:</span><span class='strut'>&nbsp;</span></p>
-<p id='t508' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; http://nbviewer.ipython.org/github/plotly/python-user-guide/blob/master/s7_streaming/s7_streaming.ipynb</span><span class='strut'>&nbsp;</span></p>
-<p id='t509' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t510' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t511' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>_stream</span><span class='op'>.</span><span class='nam'>close</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t512' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t513' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;Stream has not been opened yet.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t514' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t515' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t516' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>image</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t517' class='pln'>&nbsp; &nbsp; <span class='str'>&#39;&#39;&#39; Helper functions wrapped around plotly&#39;s static image generation api.</span><span class='strut'>&nbsp;</span></p>
-<p id='t518' class='pln'><span class='str'>&nbsp; &nbsp; &#39;&#39;&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t519' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t520' class='stm run hide_run'>&nbsp; &nbsp; <span class='op'>@</span><span class='nam'>staticmethod</span><span class='strut'>&nbsp;</span></p>
-<p id='t521' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>get</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>format</span><span class='op'>=</span><span class='str'>&#39;png&#39;</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t522' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Return a static image of the plot described by `figure`.</span><span class='strut'>&nbsp;</span></p>
-<p id='t523' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t524' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Valid formats: &#39;png&#39;, &#39;svg&#39;, &#39;jpeg&#39;, &#39;pdf&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t525' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t526' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t527' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>figure</span> <span class='op'>=</span> <span class='nam'>figure_or_data</span><span class='strut'>&nbsp;</span></p>
-<p id='t528' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t529' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>figure</span> <span class='op'>=</span> <span class='op'>{</span><span class='str'>&#39;data&#39;</span><span class='op'>:</span> <span class='nam'>figure_or_data</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
-<p id='t530' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t531' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>format</span> <span class='key'>not</span> <span class='key'>in</span> <span class='op'>[</span><span class='str'>&#39;png&#39;</span><span class='op'>,</span> <span class='str'>&#39;svg&#39;</span><span class='op'>,</span> <span class='str'>&#39;jpeg&#39;</span><span class='op'>,</span> <span class='str'>&#39;pdf&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t532' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;Invalid format. &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t533' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;This version of your Plotly-Python &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t534' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;package currently only supports &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t535' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;png, svg, jpeg, and pdf. &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t536' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Learn more about image exporting, &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t537' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;and the currently supported file &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t538' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;types here: &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t539' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;https://plot.ly/python/static-image-export/&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t540' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t541' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='op'>)</span> <span class='op'>=</span> <span class='nam'>_validation_key_logic</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t542' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>headers</span> <span class='op'>=</span> <span class='op'>{</span><span class='str'>&#39;plotly-username&#39;</span><span class='op'>:</span> <span class='nam'>username</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t543' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly-apikey&#39;</span><span class='op'>:</span> <span class='nam'>api_key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t544' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly-version&#39;</span><span class='op'>:</span> <span class='nam'>version</span><span class='op'>.</span><span class='nam'>__version__</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t545' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly-platform&#39;</span><span class='op'>:</span> <span class='str'>&#39;python&#39;</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
-<p id='t546' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t547' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>payload</span> <span class='op'>=</span> <span class='op'>{</span><span class='strut'>&nbsp;</span></p>
-<p id='t548' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;figure&#39;</span><span class='op'>:</span> <span class='nam'>figure</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t549' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;format&#39;</span><span class='op'>:</span> <span class='nam'>format</span><span class='strut'>&nbsp;</span></p>
-<p id='t550' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>}</span><span class='strut'>&nbsp;</span></p>
-<p id='t551' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t552' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>width</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t553' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>payload</span><span class='op'>[</span><span class='str'>&#39;width&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>width</span><span class='strut'>&nbsp;</span></p>
-<p id='t554' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>height</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t555' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>payload</span><span class='op'>[</span><span class='str'>&#39;height&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>height</span><span class='strut'>&nbsp;</span></p>
-<p id='t556' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t557' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>url</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>[</span><span class='str'>&#39;plotly_domain&#39;</span><span class='op'>]</span> <span class='op'>+</span> <span class='str'>&quot;/apigenimage/&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t558' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>res</span> <span class='op'>=</span> <span class='nam'>requests</span><span class='op'>.</span><span class='nam'>post</span><span class='op'>(</span><span class='nam'>url</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t559' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>data</span><span class='op'>=</span><span class='nam'>json</span><span class='op'>.</span><span class='nam'>dumps</span><span class='op'>(</span><span class='nam'>payload</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t560' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>cls</span><span class='op'>=</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>_plotlyJSONEncoder</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t561' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>headers</span><span class='op'>=</span><span class='nam'>headers</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t562' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t563' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>headers</span> <span class='op'>=</span> <span class='nam'>res</span><span class='op'>.</span><span class='nam'>headers</span><span class='strut'>&nbsp;</span></p>
+<p id='t116' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>embed</span><span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>plot_id</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>embed_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t117' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t118' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t119' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>_plot_option_logic</span><span class='op'>(</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t120' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Sets plot_options via a precedence hierarchy.&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t121' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>options</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t122' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>options</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>_DEFAULT_PLOT_OPTIONS</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t123' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>options</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>_plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t124' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>options</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t125' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;filename&#39;</span> <span class='key'>in</span> <span class='nam'>plot_options</span><span class='strut'>&nbsp;</span></p>
+<p id='t126' class='pln'>&nbsp; &nbsp; &nbsp;&nbsp; <span class='key'>and</span> <span class='str'>&#39;fileopt&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>_plot_options</span><span class='strut'>&nbsp;</span></p>
+<p id='t127' class='pln'>&nbsp; &nbsp; &nbsp;&nbsp; <span class='key'>and</span> <span class='str'>&#39;fileopt&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t128' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>options</span><span class='op'>[</span><span class='str'>&#39;fileopt&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='str'>&#39;overwrite&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t129' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>options</span><span class='strut'>&nbsp;</span></p>
+<p id='t130' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t131' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t132' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>plot</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>validate</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t133' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Create a unique url for this plot in Plotly and optionally open url.</span><span class='strut'>&nbsp;</span></p>
+<p id='t134' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t135' class='pln'><span class='str'>&nbsp; &nbsp; plot_options keyword agruments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t136' class='pln'><span class='str'>&nbsp; &nbsp; filename (string) -- the name that will be associated with this figure</span><span class='strut'>&nbsp;</span></p>
+<p id='t137' class='pln'><span class='str'>&nbsp; &nbsp; fileopt (&#39;new&#39; | &#39;overwrite&#39; | &#39;extend&#39; | &#39;append&#39;) -- &#39;new&#39; creates a</span><span class='strut'>&nbsp;</span></p>
+<p id='t138' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;new&#39;: create a new, unique url for this plot</span><span class='strut'>&nbsp;</span></p>
+<p id='t139' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;overwrite&#39;: overwrite the file associated with `filename` with this</span><span class='strut'>&nbsp;</span></p>
+<p id='t140' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;extend&#39;: add additional numbers (data) to existing traces</span><span class='strut'>&nbsp;</span></p>
+<p id='t141' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &#39;append&#39;: add additional traces to existing data lists</span><span class='strut'>&nbsp;</span></p>
+<p id='t142' class='pln'><span class='str'>&nbsp; &nbsp; world_readable (default=True) -- make this figure private/public</span><span class='strut'>&nbsp;</span></p>
+<p id='t143' class='pln'><span class='str'>&nbsp; &nbsp; auto_open (default=True) -- Toggle browser options</span><span class='strut'>&nbsp;</span></p>
+<p id='t144' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; True: open this plot in a new browser tab</span><span class='strut'>&nbsp;</span></p>
+<p id='t145' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; False: do not open plot in the browser, but do return the unique url</span><span class='strut'>&nbsp;</span></p>
+<p id='t146' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t147' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t148' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t149' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>figure</span> <span class='op'>=</span> <span class='nam'>figure_or_data</span><span class='strut'>&nbsp;</span></p>
+<p id='t150' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t151' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>figure</span> <span class='op'>=</span> <span class='op'>{</span><span class='str'>&#39;data&#39;</span><span class='op'>:</span> <span class='nam'>figure_or_data</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
+<p id='t152' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t153' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;The `figure_or_data` positional argument &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t154' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;must be either `dict`-like or &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t155' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;`list`-like.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t156' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>validate</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t157' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t158' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='nam'>figure</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='op'>=</span><span class='str'>&#39;Figure&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t159' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t160' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;Invalid &#39;figure_or_data&#39; argument. &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t161' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Plotly will not be able to properly &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t162' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;parse the resulting JSON. If you &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t163' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;want to send this &#39;figure_or_data&#39; &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t164' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;to Plotly anyway (not recommended), &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t165' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;you can set &#39;validate=False&#39; as a &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t166' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;plot option.\nHere&#39;s why you&#39;re &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t167' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;seeing this error:\n\n{}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>err</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t168' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>figure</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t169' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t170' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t171' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>len</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>)</span> <span class='op'>&gt;</span> <span class='num'>40000</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t172' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>msg</span> <span class='op'>=</span> <span class='op'>(</span><span class='str'>&quot;Woah there! Look at all those points! Due to &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t173' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;browser limitations, Plotly has a hard time &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t174' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;graphing more than 500k data points for line &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t175' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;charts, or 40k points for other types of charts. &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t176' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Here are some suggestions:\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t177' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;(1) Trying using the image API to return an image &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t178' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;instead of a graph URL\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t179' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;(2) Use matplotlib\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t180' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;(3) See if you can create your visualization with &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t181' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;fewer data points\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t182' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;If the visualization you&#39;re using aggregates &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t183' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;points (e.g., box plot, histogram, etc.) you can &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t184' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;disregard this warning.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t185' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='nam'>msg</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t186' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>TypeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t187' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t188' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>plot_options</span> <span class='op'>=</span> <span class='nam'>_plot_option_logic</span><span class='op'>(</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t189' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>res</span> <span class='op'>=</span> <span class='nam'>_send_to_plotly</span><span class='op'>(</span><span class='nam'>figure</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t190' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>res</span><span class='op'>[</span><span class='str'>&#39;error&#39;</span><span class='op'>]</span> <span class='op'>==</span> <span class='str'>&#39;&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t191' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;auto_open&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t192' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t193' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>from</span> <span class='nam'>webbrowser</span> <span class='key'>import</span> <span class='nam'>open</span> <span class='key'>as</span> <span class='nam'>wbopen</span><span class='strut'>&nbsp;</span></p>
+<p id='t194' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>wbopen</span><span class='op'>(</span><span class='nam'>res</span><span class='op'>[</span><span class='str'>&#39;url&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t195' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span><span class='op'>:</span>&nbsp; <span class='com'># TODO: what should we except here? this is dangerous</span><span class='strut'>&nbsp;</span></p>
+<p id='t196' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t197' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>res</span><span class='op'>[</span><span class='str'>&#39;url&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t198' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t199' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyAccountError</span><span class='op'>(</span><span class='nam'>res</span><span class='op'>[</span><span class='str'>&#39;error&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t200' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t201' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t202' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>iplot_mpl</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='nam'>resize</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='nam'>strip_style</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span> <span class='nam'>update</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t203' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Replot a matplotlib figure with plotly in IPython.</span><span class='strut'>&nbsp;</span></p>
+<p id='t204' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t205' class='pln'><span class='str'>&nbsp; &nbsp; This function:</span><span class='strut'>&nbsp;</span></p>
+<p id='t206' class='pln'><span class='str'>&nbsp; &nbsp; 1. converts the mpl figure into JSON (run help(plolty.tools.mpl_to_plotly))</span><span class='strut'>&nbsp;</span></p>
+<p id='t207' class='pln'><span class='str'>&nbsp; &nbsp; 2. makes a request to Plotly to save this figure in your account</span><span class='strut'>&nbsp;</span></p>
+<p id='t208' class='pln'><span class='str'>&nbsp; &nbsp; 3. displays the image in your IPython output cell</span><span class='strut'>&nbsp;</span></p>
+<p id='t209' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t210' class='pln'><span class='str'>&nbsp; &nbsp; Positional agruments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t211' class='pln'><span class='str'>&nbsp; &nbsp; fig -- a figure object from matplotlib</span><span class='strut'>&nbsp;</span></p>
+<p id='t212' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t213' class='pln'><span class='str'>&nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t214' class='pln'><span class='str'>&nbsp; &nbsp; resize (default=True) -- allow plotly to choose the figure size</span><span class='strut'>&nbsp;</span></p>
+<p id='t215' class='pln'><span class='str'>&nbsp; &nbsp; strip_style (default=False) -- allow plotly to choose style options</span><span class='strut'>&nbsp;</span></p>
+<p id='t216' class='pln'><span class='str'>&nbsp; &nbsp; update (default=None) -- update the resulting figure with an &#39;update&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t217' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; dictionary-like object resembling a plotly &#39;Figure&#39; object</span><span class='strut'>&nbsp;</span></p>
+<p id='t218' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t219' class='pln'><span class='str'>&nbsp; &nbsp; Additional keyword arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t220' class='pln'><span class='str'>&nbsp; &nbsp; plot_options -- run help(plotly.plotly.iplot)</span><span class='strut'>&nbsp;</span></p>
+<p id='t221' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t222' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t223' class='stm mis'>&nbsp; &nbsp; <span class='nam'>fig</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>mpl_to_plotly</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='nam'>resize</span><span class='op'>=</span><span class='nam'>resize</span><span class='op'>,</span> <span class='nam'>strip_style</span><span class='op'>=</span><span class='nam'>strip_style</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t224' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>update</span> <span class='key'>and</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>update</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t225' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t226' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>fig</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>update</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t227' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>fig</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t228' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t229' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_note</span><span class='op'>(</span><span class='str'>&quot;Your updated figure could not be properly validated.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t230' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t231' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
+<p id='t232' class='stm mis'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>update</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t233' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t234' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;update&#39; must be dictionary-like and a valid plotly Figure &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t235' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;object. Run &#39;help(plotly.graph_objs.Figure)&#39; for more info.&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t236' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t237' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>iplot</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t238' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t239' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t240' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>plot_mpl</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='nam'>resize</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span> <span class='nam'>strip_style</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span> <span class='nam'>update</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t241' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Replot a matplotlib figure with plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t242' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t243' class='pln'><span class='str'>&nbsp; &nbsp; This function:</span><span class='strut'>&nbsp;</span></p>
+<p id='t244' class='pln'><span class='str'>&nbsp; &nbsp; 1. converts the mpl figure into JSON (run help(plolty.tools.mpl_to_plotly))</span><span class='strut'>&nbsp;</span></p>
+<p id='t245' class='pln'><span class='str'>&nbsp; &nbsp; 2. makes a request to Plotly to save this figure in your account</span><span class='strut'>&nbsp;</span></p>
+<p id='t246' class='pln'><span class='str'>&nbsp; &nbsp; 3. opens your figure in a browser tab OR returns the unique figure url</span><span class='strut'>&nbsp;</span></p>
+<p id='t247' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t248' class='pln'><span class='str'>&nbsp; &nbsp; Positional agruments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t249' class='pln'><span class='str'>&nbsp; &nbsp; fig -- a figure object from matplotlib</span><span class='strut'>&nbsp;</span></p>
+<p id='t250' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t251' class='pln'><span class='str'>&nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t252' class='pln'><span class='str'>&nbsp; &nbsp; resize (default=True) -- allow plotly to choose the figure size</span><span class='strut'>&nbsp;</span></p>
+<p id='t253' class='pln'><span class='str'>&nbsp; &nbsp; strip_style (default=False) -- allow plotly to choose style options</span><span class='strut'>&nbsp;</span></p>
+<p id='t254' class='pln'><span class='str'>&nbsp; &nbsp; update (default=None) -- update the resulting figure with an &#39;update&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t255' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; dictionary-like object resembling a plotly &#39;Figure&#39; object</span><span class='strut'>&nbsp;</span></p>
+<p id='t256' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t257' class='pln'><span class='str'>&nbsp; &nbsp; Additional keyword arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t258' class='pln'><span class='str'>&nbsp; &nbsp; plot_options -- run help(plotly.plotly.plot)</span><span class='strut'>&nbsp;</span></p>
+<p id='t259' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t260' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t261' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>fig</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>mpl_to_plotly</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='nam'>resize</span><span class='op'>=</span><span class='nam'>resize</span><span class='op'>,</span> <span class='nam'>strip_style</span><span class='op'>=</span><span class='nam'>strip_style</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t262' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>update</span> <span class='key'>and</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>update</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t263' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t264' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>fig</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>update</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t265' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>fig</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t266' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t267' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>add_note</span><span class='op'>(</span><span class='str'>&quot;Your updated figure could not be properly validated.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t268' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>err</span><span class='op'>.</span><span class='nam'>prepare</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t269' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span><span class='strut'>&nbsp;</span></p>
+<p id='t270' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>update</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t271' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyGraphObjectError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t272' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;update&#39; must be dictionary-like and a valid plotly Figure &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t273' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;object. Run &#39;help(plotly.graph_objs.Figure)&#39; for more info.&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t274' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t275' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>plot</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t276' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t277' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t278' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_figure</span><span class='op'>(</span><span class='nam'>file_owner_or_url</span><span class='op'>,</span> <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>raw</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t279' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns a JSON figure representation for the specified file</span><span class='strut'>&nbsp;</span></p>
+<p id='t280' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t281' class='pln'><span class='str'>&nbsp; &nbsp; Plotly uniquely identifies figures with a &#39;file_owner&#39;/&#39;file_id&#39; pair.</span><span class='strut'>&nbsp;</span></p>
+<p id='t282' class='pln'><span class='str'>&nbsp; &nbsp; Since each file is given a corresponding unique url, you may also simply</span><span class='strut'>&nbsp;</span></p>
+<p id='t283' class='pln'><span class='str'>&nbsp; &nbsp; pass a valid plotly url as the first argument.</span><span class='strut'>&nbsp;</span></p>
+<p id='t284' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t285' class='pln'><span class='str'>&nbsp; &nbsp; Note, if you&#39;re using a file_owner string as the first argument, you MUST</span><span class='strut'>&nbsp;</span></p>
+<p id='t286' class='pln'><span class='str'>&nbsp; &nbsp; specify a `file_id` keyword argument. Else, if you&#39;re using a url string</span><span class='strut'>&nbsp;</span></p>
+<p id='t287' class='pln'><span class='str'>&nbsp; &nbsp; as the first argument, you MUST NOT specify a `file_id` keyword argument, or</span><span class='strut'>&nbsp;</span></p>
+<p id='t288' class='pln'><span class='str'>&nbsp; &nbsp; file_id must be set to Python&#39;s None value.</span><span class='strut'>&nbsp;</span></p>
+<p id='t289' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t290' class='pln'><span class='str'>&nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t291' class='pln'><span class='str'>&nbsp; &nbsp; file_owner_or_url (string) -- a valid plotly username OR a valid plotly url</span><span class='strut'>&nbsp;</span></p>
+<p id='t292' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t293' class='pln'><span class='str'>&nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t294' class='pln'><span class='str'>&nbsp; &nbsp; file_id (default=None) -- an int or string that can be converted to int</span><span class='strut'>&nbsp;</span></p>
+<p id='t295' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; if you&#39;re using a url, don&#39;t fill this in!</span><span class='strut'>&nbsp;</span></p>
+<p id='t296' class='pln'><span class='str'>&nbsp; &nbsp; raw (default=False) -- if true, return unicode JSON string verbatim**</span><span class='strut'>&nbsp;</span></p>
+<p id='t297' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t298' class='pln'><span class='str'>&nbsp; &nbsp; **by default, plotly will return a Figure object (run help(plotly</span><span class='strut'>&nbsp;</span></p>
+<p id='t299' class='pln'><span class='str'>&nbsp; &nbsp; .graph_objs.Figure)). This representation decodes the keys and values from</span><span class='strut'>&nbsp;</span></p>
+<p id='t300' class='pln'><span class='str'>&nbsp; &nbsp; unicode (if possible), removes information irrelevant to the figure</span><span class='strut'>&nbsp;</span></p>
+<p id='t301' class='pln'><span class='str'>&nbsp; &nbsp; representation, and converts the JSON dictionary objects to plotly</span><span class='strut'>&nbsp;</span></p>
+<p id='t302' class='pln'><span class='str'>&nbsp; &nbsp; `graph objects`.</span><span class='strut'>&nbsp;</span></p>
+<p id='t303' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t304' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t305' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>plotly_rest_url</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>[</span><span class='str'>&#39;plotly_domain&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t306' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>file_id</span> <span class='key'>is</span> <span class='nam'>None</span><span class='op'>:</span>&nbsp; <span class='com'># assume we&#39;re using a url</span><span class='strut'>&nbsp;</span></p>
+<p id='t307' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>url</span> <span class='op'>=</span> <span class='nam'>file_owner_or_url</span><span class='strut'>&nbsp;</span></p>
+<p id='t308' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>url</span><span class='op'>[</span><span class='op'>:</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>plotly_rest_url</span><span class='op'>)</span><span class='op'>]</span> <span class='op'>!=</span> <span class='nam'>plotly_rest_url</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t309' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t310' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Because you didn&#39;t supply a &#39;file_id&#39; in the call, &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t311' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;we&#39;re assuming you&#39;re trying to snag a figure from a url. &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t312' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;You supplied the url, &#39;{}&#39;, we expected it to start with &#39;{}&#39;.&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t313' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;\nRun help on this function for more information.&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t314' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>url</span><span class='op'>,</span> <span class='nam'>plotly_rest_url</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t315' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>head</span> <span class='op'>=</span> <span class='nam'>plotly_rest_url</span> <span class='op'>+</span> <span class='str'>&quot;/~&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t316' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_owner</span> <span class='op'>=</span> <span class='nam'>url</span><span class='op'>.</span><span class='nam'>replace</span><span class='op'>(</span><span class='nam'>head</span><span class='op'>,</span> <span class='str'>&quot;&quot;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>split</span><span class='op'>(</span><span class='str'>&#39;/&#39;</span><span class='op'>)</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t317' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_id</span> <span class='op'>=</span> <span class='nam'>url</span><span class='op'>.</span><span class='nam'>replace</span><span class='op'>(</span><span class='nam'>head</span><span class='op'>,</span> <span class='str'>&quot;&quot;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>split</span><span class='op'>(</span><span class='str'>&#39;/&#39;</span><span class='op'>)</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t318' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t319' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_owner</span> <span class='op'>=</span> <span class='nam'>file_owner_or_url</span><span class='strut'>&nbsp;</span></p>
+<p id='t320' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>resource</span> <span class='op'>=</span> <span class='str'>&quot;/apigetfile/{username}/{file_id}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>username</span><span class='op'>=</span><span class='nam'>file_owner</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t321' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>file_id</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t322' class='stm run hide_run'>&nbsp; &nbsp; <span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='op'>)</span> <span class='op'>=</span> <span class='nam'>_validation_key_logic</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t323' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>headers</span> <span class='op'>=</span> <span class='op'>{</span><span class='str'>&#39;plotly-username&#39;</span><span class='op'>:</span> <span class='nam'>username</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t324' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly-apikey&#39;</span><span class='op'>:</span> <span class='nam'>api_key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t325' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly-version&#39;</span><span class='op'>:</span> <span class='nam'>version</span><span class='op'>.</span><span class='nam'>__version__</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t326' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly-platform&#39;</span><span class='op'>:</span> <span class='str'>&#39;python&#39;</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
+<p id='t327' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t328' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>test_if_int</span> <span class='op'>=</span> <span class='nam'>int</span><span class='op'>(</span><span class='nam'>file_id</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t329' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>ValueError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t330' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t331' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The &#39;file_id&#39; argument was not able to be converted into an &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t332' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;integer number. Make sure that the positional &#39;file_id&#39; argument &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t333' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;is a number that can be converted into an integer or a string &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t334' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;that can be converted into an integer.&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t335' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t336' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>int</span><span class='op'>(</span><span class='nam'>file_id</span><span class='op'>)</span> <span class='op'>&lt;</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t337' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t338' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The &#39;file_id&#39; argument must be a non-negative number.&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t339' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t340' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>response</span> <span class='op'>=</span> <span class='nam'>requests</span><span class='op'>.</span><span class='nam'>get</span><span class='op'>(</span><span class='nam'>plotly_rest_url</span> <span class='op'>+</span> <span class='nam'>resource</span><span class='op'>,</span> <span class='nam'>headers</span><span class='op'>=</span><span class='nam'>headers</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t341' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>response</span><span class='op'>.</span><span class='nam'>status_code</span> <span class='op'>==</span> <span class='num'>200</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t342' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>six</span><span class='op'>.</span><span class='nam'>PY3</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t343' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>content</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>response</span><span class='op'>.</span><span class='nam'>content</span><span class='op'>.</span><span class='nam'>decode</span><span class='op'>(</span><span class='str'>&#39;unicode_escape&#39;</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t344' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t345' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>content</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>response</span><span class='op'>.</span><span class='nam'>content</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t346' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>response_payload</span> <span class='op'>=</span> <span class='nam'>content</span><span class='op'>[</span><span class='str'>&#39;payload&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t347' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>figure</span> <span class='op'>=</span> <span class='nam'>response_payload</span><span class='op'>[</span><span class='str'>&#39;figure&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t348' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>decode_unicode</span><span class='op'>(</span><span class='nam'>figure</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t349' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>raw</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t350' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>figure</span><span class='strut'>&nbsp;</span></p>
+<p id='t351' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t352' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_valid_graph_obj</span><span class='op'>(</span><span class='nam'>figure</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='op'>=</span><span class='str'>&#39;Figure&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t353' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t354' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t355' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>content</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>response</span><span class='op'>.</span><span class='nam'>content</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t356' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='nam'>content</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t357' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t358' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t359' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;There was an error retrieving this file&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t360' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t361' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t362' class='stm run hide_run'><span class='op'>@</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>template_doc</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t363' class='pln'><span class='key'>class</span> <span class='nam'>Stream</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t364' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Interface to Plotly&#39;s real-time graphing API.</span><span class='strut'>&nbsp;</span></p>
+<p id='t365' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t366' class='pln'><span class='str'>&nbsp; &nbsp; Initialize a Stream object with a stream_id</span><span class='strut'>&nbsp;</span></p>
+<p id='t367' class='pln'><span class='str'>&nbsp; &nbsp; found in {plotly_domain}/settings.</span><span class='strut'>&nbsp;</span></p>
+<p id='t368' class='pln'><span class='str'>&nbsp; &nbsp; Real-time graphs are initialized with a call to `plot` that embeds</span><span class='strut'>&nbsp;</span></p>
+<p id='t369' class='pln'><span class='str'>&nbsp; &nbsp; your unique `stream_id`s in each of the graph&#39;s traces. The `Stream`</span><span class='strut'>&nbsp;</span></p>
+<p id='t370' class='pln'><span class='str'>&nbsp; &nbsp; interface plots data to these traces, as identified with the unique</span><span class='strut'>&nbsp;</span></p>
+<p id='t371' class='pln'><span class='str'>&nbsp; &nbsp; stream_id, in real-time.</span><span class='strut'>&nbsp;</span></p>
+<p id='t372' class='pln'><span class='str'>&nbsp; &nbsp; Every viewer of the graph sees the same data at the same time.</span><span class='strut'>&nbsp;</span></p>
+<p id='t373' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t374' class='pln'><span class='str'>&nbsp; &nbsp; View examples and tutorials here:</span><span class='strut'>&nbsp;</span></p>
+<p id='t375' class='pln'><span class='str'>&nbsp; &nbsp; http://nbviewer.ipython.org/github/plotly/python-user-guide/blob/master/s7_streaming/s7_streaming.ipynb</span><span class='strut'>&nbsp;</span></p>
+<p id='t376' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t377' class='pln'><span class='str'>&nbsp; &nbsp; Stream example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t378' class='pln'><span class='str'>&nbsp; &nbsp; # Initialize a streaming graph</span><span class='strut'>&nbsp;</span></p>
+<p id='t379' class='pln'><span class='str'>&nbsp; &nbsp; # by embedding stream_id&#39;s in the graph&#39;s traces</span><span class='strut'>&nbsp;</span></p>
+<p id='t380' class='pln'><span class='str'>&nbsp; &nbsp; &gt;&gt;&gt; stream_id = &quot;your_stream_id&quot; # See {plotly_domain}/settings</span><span class='strut'>&nbsp;</span></p>
+<p id='t381' class='pln'><span class='str'>&nbsp; &nbsp; &gt;&gt;&gt; py.plot(Data([Scatter(x=[],</span><span class='strut'>&nbsp;</span></p>
+<p id='t382' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; y=[],</span><span class='strut'>&nbsp;</span></p>
+<p id='t383' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; stream=dict(token=stream_id, maxpoints=100))])</span><span class='strut'>&nbsp;</span></p>
+<p id='t384' class='pln'><span class='str'>&nbsp; &nbsp; # Stream data to the import trace</span><span class='strut'>&nbsp;</span></p>
+<p id='t385' class='pln'><span class='str'>&nbsp; &nbsp; &gt;&gt;&gt; stream = Stream(stream_id) # Initialize a stream object</span><span class='strut'>&nbsp;</span></p>
+<p id='t386' class='pln'><span class='str'>&nbsp; &nbsp; &gt;&gt;&gt; stream.open() # Open the stream</span><span class='strut'>&nbsp;</span></p>
+<p id='t387' class='pln'><span class='str'>&nbsp; &nbsp; &gt;&gt;&gt; stream.write(dict(x=1, y=1)) # Plot (1, 1) in your graph</span><span class='strut'>&nbsp;</span></p>
+<p id='t388' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t389' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t390' class='stm run hide_run'>&nbsp; &nbsp; <span class='op'>@</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>template_doc</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t391' class='pln'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>__init__</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>stream_id</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t392' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Initialize a Stream object with your unique stream_id.</span><span class='strut'>&nbsp;</span></p>
+<p id='t393' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Find your stream_id at {plotly_domain}/settings.</span><span class='strut'>&nbsp;</span></p>
+<p id='t394' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t395' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; For more help, see: `help(plotly.plotly.Stream)`</span><span class='strut'>&nbsp;</span></p>
+<p id='t396' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; or see examples and tutorials here:</span><span class='strut'>&nbsp;</span></p>
+<p id='t397' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; http://nbviewer.ipython.org/github/plotly/python-user-guide/blob/master/s7_streaming/s7_streaming.ipynb</span><span class='strut'>&nbsp;</span></p>
+<p id='t398' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t399' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>stream_id</span> <span class='op'>=</span> <span class='nam'>stream_id</span><span class='strut'>&nbsp;</span></p>
+<p id='t400' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>connected</span> <span class='op'>=</span> <span class='nam'>False</span><span class='strut'>&nbsp;</span></p>
+<p id='t401' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t402' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>open</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t403' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Open streaming connection to plotly.</span><span class='strut'>&nbsp;</span></p>
+<p id='t404' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t405' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; For more help, see: `help(plotly.plotly.Stream)`</span><span class='strut'>&nbsp;</span></p>
+<p id='t406' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; or see examples and tutorials here:</span><span class='strut'>&nbsp;</span></p>
+<p id='t407' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; http://nbviewer.ipython.org/github/plotly/python-user-guide/blob/master/s7_streaming/s7_streaming.ipynb</span><span class='strut'>&nbsp;</span></p>
+<p id='t408' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t409' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t410' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>streaming_url</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>[</span><span class='str'>&#39;plotly_streaming_domain&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t411' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>_stream</span> <span class='op'>=</span> <span class='nam'>chunked_requests</span><span class='op'>.</span><span class='nam'>Stream</span><span class='op'>(</span><span class='nam'>streaming_url</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t412' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='num'>80</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t413' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='op'>{</span><span class='str'>&#39;Host&#39;</span><span class='op'>:</span> <span class='nam'>streaming_url</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t414' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;plotly-streamtoken&#39;</span><span class='op'>:</span> <span class='nam'>self</span><span class='op'>.</span><span class='nam'>stream_id</span><span class='op'>}</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t415' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t416' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>write</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>,</span> <span class='nam'>trace</span><span class='op'>,</span> <span class='nam'>layout</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>validate</span><span class='op'>=</span><span class='nam'>True</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t417' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>reconnect_on</span><span class='op'>=</span><span class='op'>(</span><span class='num'>200</span><span class='op'>,</span> <span class='str'>&#39;&#39;</span><span class='op'>,</span> <span class='num'>408</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t418' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Write to an open stream.</span><span class='strut'>&nbsp;</span></p>
+<p id='t419' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t420' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Once you&#39;ve instantiated a &#39;Stream&#39; object with a &#39;stream_id&#39;,</span><span class='strut'>&nbsp;</span></p>
+<p id='t421' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; you can &#39;write&#39; to it in real time.</span><span class='strut'>&nbsp;</span></p>
+<p id='t422' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t423' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; positional arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t424' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; trace - A valid plotly trace object (e.g., Scatter, Heatmap, etc.).</span><span class='strut'>&nbsp;</span></p>
+<p id='t425' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Not all keys in these are `stremable` run help(Obj) on the type</span><span class='strut'>&nbsp;</span></p>
+<p id='t426' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; of trace your trying to stream, for each valid key, if the key</span><span class='strut'>&nbsp;</span></p>
+<p id='t427' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; is streamable, it will say &#39;streamable = True&#39;. Trace objects</span><span class='strut'>&nbsp;</span></p>
+<p id='t428' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; must be dictionary-like.</span><span class='strut'>&nbsp;</span></p>
+<p id='t429' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t430' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; keyword arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t431' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; layout (default=None) - A valid Layout object</span><span class='strut'>&nbsp;</span></p>
+<p id='t432' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Run help(plotly.graph_objs.Layout)</span><span class='strut'>&nbsp;</span></p>
+<p id='t433' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; validate (default = True) - Validate this stream before sending?</span><span class='strut'>&nbsp;</span></p>
+<p id='t434' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; This will catch local errors if set to True.</span><span class='strut'>&nbsp;</span></p>
+<p id='t435' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t436' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Some valid keys for trace dictionaries:</span><span class='strut'>&nbsp;</span></p>
+<p id='t437' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &#39;x&#39;, &#39;y&#39;, &#39;text&#39;, &#39;z&#39;, &#39;marker&#39;, &#39;line&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t438' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t439' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Examples:</span><span class='strut'>&nbsp;</span></p>
+<p id='t440' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &gt;&gt;&gt; write(dict(x=1, y=2))&nbsp; # assumes &#39;scatter&#39; type</span><span class='strut'>&nbsp;</span></p>
+<p id='t441' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &gt;&gt;&gt; write(Bar(x=[1, 2, 3], y=[10, 20, 30]))</span><span class='strut'>&nbsp;</span></p>
+<p id='t442' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &gt;&gt;&gt; write(Scatter(x=1, y=2, text=&#39;scatter text&#39;))</span><span class='strut'>&nbsp;</span></p>
+<p id='t443' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &gt;&gt;&gt; write(Scatter(x=1, y=3, marker=Marker(color=&#39;blue&#39;)))</span><span class='strut'>&nbsp;</span></p>
+<p id='t444' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &gt;&gt;&gt; write(Heatmap(z=[[1, 2, 3], [4, 5, 6]]))</span><span class='strut'>&nbsp;</span></p>
+<p id='t445' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t446' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; The connection to plotly&#39;s servers is checked before writing</span><span class='strut'>&nbsp;</span></p>
+<p id='t447' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; and reconnected if disconnected and if the response status code</span><span class='strut'>&nbsp;</span></p>
+<p id='t448' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; is in `reconnect_on`.</span><span class='strut'>&nbsp;</span></p>
+<p id='t449' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t450' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; For more help, see: `help(plotly.plotly.Stream)`</span><span class='strut'>&nbsp;</span></p>
+<p id='t451' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; or see examples and tutorials here:</span><span class='strut'>&nbsp;</span></p>
+<p id='t452' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; http://nbviewer.ipython.org/github/plotly/python-user-guide/blob/master/s7_streaming/s7_streaming.ipynb</span><span class='strut'>&nbsp;</span></p>
+<p id='t453' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t454' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>stream_object</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t455' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>stream_object</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>trace</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t456' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;type&#39;</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>stream_object</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t457' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>stream_object</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='str'>&#39;scatter&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t458' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>validate</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t459' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t460' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='nam'>stream_object</span><span class='op'>,</span> <span class='nam'>stream_object</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t461' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t462' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t463' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Part of the data object with type, &#39;{}&#39;, is invalid. This &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t464' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;will default to &#39;scatter&#39; if you do not supply a &#39;type&#39;. &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t465' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;If you do not want to validate your data objects when &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t466' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;streaming, you can set &#39;validate=False&#39; in the call to &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t467' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;your_stream.write()&#39;. Here&#39;s why the object is &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t468' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;invalid:\n\n{}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>stream_object</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>err</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t469' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t470' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t471' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>validate_stream</span><span class='op'>(</span><span class='nam'>stream_object</span><span class='op'>,</span> <span class='nam'>stream_object</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t472' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t473' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t474' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Part of the data object with type, &#39;{}&#39;, cannot yet be &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t475' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;streamed into Plotly. If you do not want to validate your &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t476' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;data objects when streaming, you can set &#39;validate=False&#39; &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t477' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;in the call to &#39;your_stream.write()&#39;. Here&#39;s why the &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t478' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;object cannot be streamed:\n\n{}&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t479' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>stream_object</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>err</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t480' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t481' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>layout</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t482' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t483' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>validate</span><span class='op'>(</span><span class='nam'>layout</span><span class='op'>,</span> <span class='str'>&#39;Layout&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t484' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span> <span class='key'>as</span> <span class='nam'>err</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t485' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t486' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Your layout kwarg was invalid. &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t487' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Here&#39;s why:\n\n{}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>err</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t488' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t489' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>stream_object</span><span class='op'>[</span><span class='str'>&#39;type&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t490' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t491' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>layout</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t492' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>stream_object</span><span class='op'>.</span><span class='nam'>update</span><span class='op'>(</span><span class='nam'>dict</span><span class='op'>(</span><span class='nam'>layout</span><span class='op'>=</span><span class='nam'>layout</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t493' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t494' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># TODO: allow string version of this?</span><span class='strut'>&nbsp;</span></p>
+<p id='t495' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>jdata</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>dumps</span><span class='op'>(</span><span class='nam'>stream_object</span><span class='op'>,</span> <span class='nam'>cls</span><span class='op'>=</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>_plotlyJSONEncoder</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t496' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>jdata</span> <span class='op'>+=</span> <span class='str'>&quot;\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t497' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t498' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t499' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>_stream</span><span class='op'>.</span><span class='nam'>write</span><span class='op'>(</span><span class='nam'>jdata</span><span class='op'>,</span> <span class='nam'>reconnect_on</span><span class='op'>=</span><span class='nam'>reconnect_on</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t500' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t501' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;Stream has not been opened yet, &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t502' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;cannot write to a closed connection. &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t503' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Call `open()` on the stream to open the stream.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t504' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t505' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>close</span><span class='op'>(</span><span class='nam'>self</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t506' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Close the stream connection to plotly&#39;s streaming servers.</span><span class='strut'>&nbsp;</span></p>
+<p id='t507' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t508' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; For more help, see: `help(plotly.plotly.Stream)`</span><span class='strut'>&nbsp;</span></p>
+<p id='t509' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; or see examples and tutorials here:</span><span class='strut'>&nbsp;</span></p>
+<p id='t510' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; http://nbviewer.ipython.org/github/plotly/python-user-guide/blob/master/s7_streaming/s7_streaming.ipynb</span><span class='strut'>&nbsp;</span></p>
+<p id='t511' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t512' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t513' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>self</span><span class='op'>.</span><span class='nam'>_stream</span><span class='op'>.</span><span class='nam'>close</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t514' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>AttributeError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t515' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;Stream has not been opened yet.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t516' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t517' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t518' class='stm run hide_run'><span class='key'>class</span> <span class='nam'>image</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t519' class='pln'>&nbsp; &nbsp; <span class='str'>&#39;&#39;&#39; Helper functions wrapped around plotly&#39;s static image generation api.</span><span class='strut'>&nbsp;</span></p>
+<p id='t520' class='pln'><span class='str'>&nbsp; &nbsp; &#39;&#39;&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t521' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t522' class='stm run hide_run'>&nbsp; &nbsp; <span class='op'>@</span><span class='nam'>staticmethod</span><span class='strut'>&nbsp;</span></p>
+<p id='t523' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>get</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>format</span><span class='op'>=</span><span class='str'>&#39;png&#39;</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t524' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Return a static image of the plot described by `figure`.</span><span class='strut'>&nbsp;</span></p>
+<p id='t525' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t526' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Valid formats: &#39;png&#39;, &#39;svg&#39;, &#39;jpeg&#39;, &#39;pdf&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t527' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t528' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t529' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>figure</span> <span class='op'>=</span> <span class='nam'>figure_or_data</span><span class='strut'>&nbsp;</span></p>
+<p id='t530' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t531' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>figure</span> <span class='op'>=</span> <span class='op'>{</span><span class='str'>&#39;data&#39;</span><span class='op'>:</span> <span class='nam'>figure_or_data</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
+<p id='t532' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t533' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>format</span> <span class='key'>not</span> <span class='key'>in</span> <span class='op'>[</span><span class='str'>&#39;png&#39;</span><span class='op'>,</span> <span class='str'>&#39;svg&#39;</span><span class='op'>,</span> <span class='str'>&#39;jpeg&#39;</span><span class='op'>,</span> <span class='str'>&#39;pdf&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t534' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;Invalid format. &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t535' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;This version of your Plotly-Python &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t536' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;package currently only supports &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t537' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;png, svg, jpeg, and pdf. &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t538' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;Learn more about image exporting, &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t539' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;and the currently supported file &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t540' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;types here: &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t541' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;https://plot.ly/python/static-image-export/&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t542' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t543' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='op'>)</span> <span class='op'>=</span> <span class='nam'>_validation_key_logic</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t544' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>headers</span> <span class='op'>=</span> <span class='op'>{</span><span class='str'>&#39;plotly-username&#39;</span><span class='op'>:</span> <span class='nam'>username</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t545' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly-apikey&#39;</span><span class='op'>:</span> <span class='nam'>api_key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t546' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly-version&#39;</span><span class='op'>:</span> <span class='nam'>version</span><span class='op'>.</span><span class='nam'>__version__</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t547' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly-platform&#39;</span><span class='op'>:</span> <span class='str'>&#39;python&#39;</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
+<p id='t548' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t549' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>payload</span> <span class='op'>=</span> <span class='op'>{</span><span class='strut'>&nbsp;</span></p>
+<p id='t550' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;figure&#39;</span><span class='op'>:</span> <span class='nam'>figure</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t551' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;format&#39;</span><span class='op'>:</span> <span class='nam'>format</span><span class='strut'>&nbsp;</span></p>
+<p id='t552' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>}</span><span class='strut'>&nbsp;</span></p>
+<p id='t553' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t554' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>width</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t555' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>payload</span><span class='op'>[</span><span class='str'>&#39;width&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>width</span><span class='strut'>&nbsp;</span></p>
+<p id='t556' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>height</span> <span class='key'>is</span> <span class='key'>not</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t557' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>payload</span><span class='op'>[</span><span class='str'>&#39;height&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>height</span><span class='strut'>&nbsp;</span></p>
+<p id='t558' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t559' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>url</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>[</span><span class='str'>&#39;plotly_domain&#39;</span><span class='op'>]</span> <span class='op'>+</span> <span class='str'>&quot;/apigenimage/&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t560' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>res</span> <span class='op'>=</span> <span class='nam'>requests</span><span class='op'>.</span><span class='nam'>post</span><span class='op'>(</span><span class='nam'>url</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t561' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>data</span><span class='op'>=</span><span class='nam'>json</span><span class='op'>.</span><span class='nam'>dumps</span><span class='op'>(</span><span class='nam'>payload</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t562' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>cls</span><span class='op'>=</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>_plotlyJSONEncoder</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t563' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>headers</span><span class='op'>=</span><span class='nam'>headers</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
 <p id='t564' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t565' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>res</span><span class='op'>.</span><span class='nam'>status_code</span> <span class='op'>==</span> <span class='num'>200</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t566' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;content-type&#39;</span> <span class='key'>in</span> <span class='nam'>headers</span> <span class='key'>and</span><span class='strut'>&nbsp;</span></p>
-<p id='t567' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>headers</span><span class='op'>[</span><span class='str'>&#39;content-type&#39;</span><span class='op'>]</span> <span class='key'>in</span> <span class='op'>[</span><span class='str'>&#39;image/png&#39;</span><span class='op'>,</span> <span class='str'>&#39;image/jpeg&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t568' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;application/pdf&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t569' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;image/svg+xml&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t570' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>res</span><span class='op'>.</span><span class='nam'>content</span><span class='strut'>&nbsp;</span></p>
-<p id='t571' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t572' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='op'>(</span><span class='str'>&#39;content-type&#39;</span> <span class='key'>in</span> <span class='nam'>headers</span> <span class='key'>and</span><span class='strut'>&nbsp;</span></p>
-<p id='t573' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;json&#39;</span> <span class='key'>in</span> <span class='nam'>headers</span><span class='op'>[</span><span class='str'>&#39;content-type&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t574' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>return_data</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>res</span><span class='op'>.</span><span class='nam'>content</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t575' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>return_data</span><span class='op'>[</span><span class='str'>&#39;image&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t576' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t577' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t578' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;content-type&#39;</span> <span class='key'>in</span> <span class='nam'>headers</span> <span class='key'>and</span><span class='strut'>&nbsp;</span></p>
-<p id='t579' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;json&#39;</span> <span class='key'>in</span> <span class='nam'>headers</span><span class='op'>[</span><span class='str'>&#39;content-type&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t580' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>return_data</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>res</span><span class='op'>.</span><span class='nam'>content</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t581' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t582' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>return_data</span> <span class='op'>=</span> <span class='op'>{</span><span class='str'>&#39;error&#39;</span><span class='op'>:</span> <span class='nam'>res</span><span class='op'>.</span><span class='nam'>content</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
-<p id='t583' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t584' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;The response &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t585' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;from plotly could &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t586' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;not be translated.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t587' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='nam'>return_data</span><span class='op'>[</span><span class='str'>&#39;error&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t588' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t589' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t590' class='stm run hide_run'>&nbsp; &nbsp; <span class='op'>@</span><span class='nam'>classmethod</span><span class='strut'>&nbsp;</span></p>
-<p id='t591' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>ishow</span><span class='op'>(</span><span class='nam'>cls</span><span class='op'>,</span> <span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>format</span><span class='op'>=</span><span class='str'>&#39;png&#39;</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t592' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Display a static image of the plot described by `figure`</span><span class='strut'>&nbsp;</span></p>
-<p id='t593' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; in an IPython Notebook.</span><span class='strut'>&nbsp;</span></p>
-<p id='t594' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t595' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>format</span> <span class='op'>==</span> <span class='str'>&#39;pdf&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t596' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;Aw, snap! &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t597' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;It&#39;s not currently possible to embed a pdf into &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t598' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;an IPython notebook. You can save the pdf &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t599' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;with the `image.save_as` or you can &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t600' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;embed an png, jpeg, or svg.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t601' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>img</span> <span class='op'>=</span> <span class='nam'>cls</span><span class='op'>.</span><span class='nam'>get</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>format</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t602' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>from</span> <span class='nam'>IPython</span><span class='op'>.</span><span class='nam'>display</span> <span class='key'>import</span> <span class='nam'>display</span><span class='op'>,</span> <span class='nam'>Image</span><span class='op'>,</span> <span class='nam'>SVG</span><span class='strut'>&nbsp;</span></p>
-<p id='t603' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>format</span> <span class='op'>==</span> <span class='str'>&#39;svg&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t604' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>display</span><span class='op'>(</span><span class='nam'>SVG</span><span class='op'>(</span><span class='nam'>img</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t605' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t606' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>display</span><span class='op'>(</span><span class='nam'>Image</span><span class='op'>(</span><span class='nam'>img</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t607' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t608' class='stm run hide_run'>&nbsp; &nbsp; <span class='op'>@</span><span class='nam'>classmethod</span><span class='strut'>&nbsp;</span></p>
-<p id='t609' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>save_as</span><span class='op'>(</span><span class='nam'>cls</span><span class='op'>,</span> <span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>filename</span><span class='op'>,</span> <span class='nam'>format</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t610' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Save a static image of the plot described by `figure` locally as `filename`.</span><span class='strut'>&nbsp;</span></p>
-<p id='t611' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Valid image formats are &#39;png&#39;, &#39;svg&#39;, &#39;jpeg&#39;, and &#39;pdf&#39;.</span><span class='strut'>&nbsp;</span></p>
-<p id='t612' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; The format is taken as the extension of the filename or as the supplied format.</span><span class='strut'>&nbsp;</span></p>
-<p id='t613' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t614' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>(</span><span class='nam'>base</span><span class='op'>,</span> <span class='nam'>ext</span><span class='op'>)</span> <span class='op'>=</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>splitext</span><span class='op'>(</span><span class='nam'>filename</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t615' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>ext</span> <span class='key'>and</span> <span class='key'>not</span> <span class='nam'>format</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t616' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>filename</span> <span class='op'>+=</span> <span class='str'>&#39;.png&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t617' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>ext</span> <span class='key'>and</span> <span class='key'>not</span> <span class='nam'>format</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t618' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>format</span> <span class='op'>=</span> <span class='nam'>ext</span><span class='op'>[</span><span class='num'>1</span><span class='op'>:</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t619' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='key'>not</span> <span class='nam'>ext</span> <span class='key'>and</span> <span class='nam'>format</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t620' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>filename</span> <span class='op'>+=</span> <span class='str'>&#39;.&#39;</span><span class='op'>+</span><span class='nam'>format</span><span class='strut'>&nbsp;</span></p>
-<p id='t621' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t565' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>headers</span> <span class='op'>=</span> <span class='nam'>res</span><span class='op'>.</span><span class='nam'>headers</span><span class='strut'>&nbsp;</span></p>
+<p id='t566' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t567' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>res</span><span class='op'>.</span><span class='nam'>status_code</span> <span class='op'>==</span> <span class='num'>200</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t568' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;content-type&#39;</span> <span class='key'>in</span> <span class='nam'>headers</span> <span class='key'>and</span><span class='strut'>&nbsp;</span></p>
+<p id='t569' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>headers</span><span class='op'>[</span><span class='str'>&#39;content-type&#39;</span><span class='op'>]</span> <span class='key'>in</span> <span class='op'>[</span><span class='str'>&#39;image/png&#39;</span><span class='op'>,</span> <span class='str'>&#39;image/jpeg&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t570' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;application/pdf&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t571' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;image/svg+xml&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t572' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>res</span><span class='op'>.</span><span class='nam'>content</span><span class='strut'>&nbsp;</span></p>
+<p id='t573' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t574' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='op'>(</span><span class='str'>&#39;content-type&#39;</span> <span class='key'>in</span> <span class='nam'>headers</span> <span class='key'>and</span><span class='strut'>&nbsp;</span></p>
+<p id='t575' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;json&#39;</span> <span class='key'>in</span> <span class='nam'>headers</span><span class='op'>[</span><span class='str'>&#39;content-type&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t576' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>return_data</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>res</span><span class='op'>.</span><span class='nam'>content</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t577' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>return_data</span><span class='op'>[</span><span class='str'>&#39;image&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t578' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t579' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t580' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;content-type&#39;</span> <span class='key'>in</span> <span class='nam'>headers</span> <span class='key'>and</span><span class='strut'>&nbsp;</span></p>
+<p id='t581' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;json&#39;</span> <span class='key'>in</span> <span class='nam'>headers</span><span class='op'>[</span><span class='str'>&#39;content-type&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t582' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>return_data</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>res</span><span class='op'>.</span><span class='nam'>content</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t583' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t584' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>return_data</span> <span class='op'>=</span> <span class='op'>{</span><span class='str'>&#39;error&#39;</span><span class='op'>:</span> <span class='nam'>res</span><span class='op'>.</span><span class='nam'>content</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
+<p id='t585' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t586' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;The response &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t587' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;from plotly could &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t588' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;not be translated.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t589' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='nam'>return_data</span><span class='op'>[</span><span class='str'>&#39;error&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t590' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t591' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t592' class='stm run hide_run'>&nbsp; &nbsp; <span class='op'>@</span><span class='nam'>classmethod</span><span class='strut'>&nbsp;</span></p>
+<p id='t593' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>ishow</span><span class='op'>(</span><span class='nam'>cls</span><span class='op'>,</span> <span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>format</span><span class='op'>=</span><span class='str'>&#39;png&#39;</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t594' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Display a static image of the plot described by `figure`</span><span class='strut'>&nbsp;</span></p>
+<p id='t595' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; in an IPython Notebook.</span><span class='strut'>&nbsp;</span></p>
+<p id='t596' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t597' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>format</span> <span class='op'>==</span> <span class='str'>&#39;pdf&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t598' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;Aw, snap! &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t599' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;It&#39;s not currently possible to embed a pdf into &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t600' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;an IPython notebook. You can save the pdf &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t601' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;with the `image.save_as` or you can &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t602' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;embed an png, jpeg, or svg.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t603' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>img</span> <span class='op'>=</span> <span class='nam'>cls</span><span class='op'>.</span><span class='nam'>get</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>format</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t604' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>from</span> <span class='nam'>IPython</span><span class='op'>.</span><span class='nam'>display</span> <span class='key'>import</span> <span class='nam'>display</span><span class='op'>,</span> <span class='nam'>Image</span><span class='op'>,</span> <span class='nam'>SVG</span><span class='strut'>&nbsp;</span></p>
+<p id='t605' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>format</span> <span class='op'>==</span> <span class='str'>&#39;svg&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t606' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>display</span><span class='op'>(</span><span class='nam'>SVG</span><span class='op'>(</span><span class='nam'>img</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t607' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t608' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>display</span><span class='op'>(</span><span class='nam'>Image</span><span class='op'>(</span><span class='nam'>img</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t609' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t610' class='stm run hide_run'>&nbsp; &nbsp; <span class='op'>@</span><span class='nam'>classmethod</span><span class='strut'>&nbsp;</span></p>
+<p id='t611' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>def</span> <span class='nam'>save_as</span><span class='op'>(</span><span class='nam'>cls</span><span class='op'>,</span> <span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>filename</span><span class='op'>,</span> <span class='nam'>format</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t612' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;&quot; Save a static image of the plot described by `figure` locally as `filename`.</span><span class='strut'>&nbsp;</span></p>
+<p id='t613' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Valid image formats are &#39;png&#39;, &#39;svg&#39;, &#39;jpeg&#39;, and &#39;pdf&#39;.</span><span class='strut'>&nbsp;</span></p>
+<p id='t614' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; The format is taken as the extension of the filename or as the supplied format.</span><span class='strut'>&nbsp;</span></p>
+<p id='t615' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t616' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>(</span><span class='nam'>base</span><span class='op'>,</span> <span class='nam'>ext</span><span class='op'>)</span> <span class='op'>=</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>splitext</span><span class='op'>(</span><span class='nam'>filename</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t617' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>ext</span> <span class='key'>and</span> <span class='key'>not</span> <span class='nam'>format</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t618' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>filename</span> <span class='op'>+=</span> <span class='str'>&#39;.png&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t619' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>ext</span> <span class='key'>and</span> <span class='key'>not</span> <span class='nam'>format</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t620' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>format</span> <span class='op'>=</span> <span class='nam'>ext</span><span class='op'>[</span><span class='num'>1</span><span class='op'>:</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t621' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>elif</span> <span class='key'>not</span> <span class='nam'>ext</span> <span class='key'>and</span> <span class='nam'>format</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
 <p id='t622' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>filename</span> <span class='op'>+=</span> <span class='str'>&#39;.&#39;</span><span class='op'>+</span><span class='nam'>format</span><span class='strut'>&nbsp;</span></p>
-<p id='t623' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t624' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>img</span> <span class='op'>=</span> <span class='nam'>cls</span><span class='op'>.</span><span class='nam'>get</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>format</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t623' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t624' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>filename</span> <span class='op'>+=</span> <span class='str'>&#39;.&#39;</span><span class='op'>+</span><span class='nam'>format</span><span class='strut'>&nbsp;</span></p>
 <p id='t625' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t626' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>f</span> <span class='op'>=</span> <span class='nam'>open</span><span class='op'>(</span><span class='nam'>filename</span><span class='op'>,</span> <span class='str'>&#39;wb&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t627' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>f</span><span class='op'>.</span><span class='nam'>write</span><span class='op'>(</span><span class='nam'>img</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t628' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>f</span><span class='op'>.</span><span class='nam'>close</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t629' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t630' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t631' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>_send_to_plotly</span><span class='op'>(</span><span class='nam'>figure</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t632' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t633' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t634' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>fig</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>_replace_newline</span><span class='op'>(</span><span class='nam'>figure</span><span class='op'>)</span>&nbsp; <span class='com'># does not mutate figure</span><span class='strut'>&nbsp;</span></p>
-<p id='t635' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>data</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>dumps</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span> <span class='key'>if</span> <span class='str'>&#39;data&#39;</span> <span class='key'>in</span> <span class='nam'>fig</span> <span class='key'>else</span> <span class='op'>[</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t636' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>cls</span><span class='op'>=</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>_plotlyJSONEncoder</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t637' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>file_credentials</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_credentials_file</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t638' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;username&#39;</span> <span class='key'>in</span> <span class='nam'>_credentials</span><span class='op'>)</span> <span class='key'>and</span> <span class='op'>(</span><span class='str'>&#39;api_key&#39;</span> <span class='key'>in</span> <span class='nam'>_credentials</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t639' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span> <span class='op'>=</span> <span class='nam'>_credentials</span><span class='op'>[</span><span class='str'>&#39;username&#39;</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>_credentials</span><span class='op'>[</span><span class='str'>&#39;api_key&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t640' class='stm mis'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='op'>(</span><span class='str'>&#39;username&#39;</span> <span class='key'>in</span> <span class='nam'>file_credentials</span><span class='op'>)</span> <span class='key'>and</span> <span class='op'>(</span><span class='str'>&#39;api_key&#39;</span> <span class='key'>in</span> <span class='nam'>file_credentials</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t641' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='op'>)</span> <span class='op'>=</span> <span class='op'>(</span><span class='nam'>file_credentials</span><span class='op'>[</span><span class='str'>&#39;username&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t642' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>file_credentials</span><span class='op'>[</span><span class='str'>&#39;api_key&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t643' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t644' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyLocalCredentialsError</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t645' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t646' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>kwargs</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>dumps</span><span class='op'>(</span><span class='nam'>dict</span><span class='op'>(</span><span class='nam'>filename</span><span class='op'>=</span><span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;filename&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t647' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>fileopt</span><span class='op'>=</span><span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;fileopt&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t648' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>world_readable</span><span class='op'>=</span><span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;world_readable&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t649' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>layout</span><span class='op'>=</span><span class='nam'>fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span> <span class='key'>if</span> <span class='str'>&#39;layout&#39;</span> <span class='key'>in</span> <span class='nam'>fig</span><span class='strut'>&nbsp;</span></p>
-<p id='t650' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='key'>else</span> <span class='op'>{</span><span class='op'>}</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t651' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>cls</span><span class='op'>=</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>_plotlyJSONEncoder</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t652' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t653' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t654' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>payload</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='nam'>platform</span><span class='op'>=</span><span class='str'>&#39;python&#39;</span><span class='op'>,</span> <span class='com'># TODO: It&#39;d be cool to expose the platform for RaspPi and others</span><span class='strut'>&nbsp;</span></p>
-<p id='t655' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>version</span><span class='op'>=</span><span class='nam'>version</span><span class='op'>.</span><span class='nam'>__version__</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t656' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>args</span><span class='op'>=</span><span class='nam'>data</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t657' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>un</span><span class='op'>=</span><span class='nam'>username</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t658' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>api_key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t659' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>origin</span><span class='op'>=</span><span class='str'>&#39;plot&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t660' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>kwargs</span><span class='op'>=</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t661' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t662' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>url</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>[</span><span class='str'>&#39;plotly_domain&#39;</span><span class='op'>]</span> <span class='op'>+</span> <span class='str'>&quot;/clientresp&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t626' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>img</span> <span class='op'>=</span> <span class='nam'>cls</span><span class='op'>.</span><span class='nam'>get</span><span class='op'>(</span><span class='nam'>figure_or_data</span><span class='op'>,</span> <span class='nam'>format</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t627' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t628' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>f</span> <span class='op'>=</span> <span class='nam'>open</span><span class='op'>(</span><span class='nam'>filename</span><span class='op'>,</span> <span class='str'>&#39;wb&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t629' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>f</span><span class='op'>.</span><span class='nam'>write</span><span class='op'>(</span><span class='nam'>img</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t630' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>f</span><span class='op'>.</span><span class='nam'>close</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t631' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t632' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t633' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>_send_to_plotly</span><span class='op'>(</span><span class='nam'>figure</span><span class='op'>,</span> <span class='op'>**</span><span class='nam'>plot_options</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t634' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t635' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t636' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>fig</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>_replace_newline</span><span class='op'>(</span><span class='nam'>figure</span><span class='op'>)</span>&nbsp; <span class='com'># does not mutate figure</span><span class='strut'>&nbsp;</span></p>
+<p id='t637' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>data</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>dumps</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>[</span><span class='str'>&#39;data&#39;</span><span class='op'>]</span> <span class='key'>if</span> <span class='str'>&#39;data&#39;</span> <span class='key'>in</span> <span class='nam'>fig</span> <span class='key'>else</span> <span class='op'>[</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t638' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>cls</span><span class='op'>=</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>_plotlyJSONEncoder</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t639' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>file_credentials</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_credentials_file</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t640' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='op'>(</span><span class='str'>&#39;username&#39;</span> <span class='key'>in</span> <span class='nam'>_credentials</span><span class='op'>)</span> <span class='key'>and</span> <span class='op'>(</span><span class='str'>&#39;api_key&#39;</span> <span class='key'>in</span> <span class='nam'>_credentials</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t641' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span> <span class='op'>=</span> <span class='nam'>_credentials</span><span class='op'>[</span><span class='str'>&#39;username&#39;</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>_credentials</span><span class='op'>[</span><span class='str'>&#39;api_key&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t642' class='stm mis'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='op'>(</span><span class='str'>&#39;username&#39;</span> <span class='key'>in</span> <span class='nam'>file_credentials</span><span class='op'>)</span> <span class='key'>and</span> <span class='op'>(</span><span class='str'>&#39;api_key&#39;</span> <span class='key'>in</span> <span class='nam'>file_credentials</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t643' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='op'>)</span> <span class='op'>=</span> <span class='op'>(</span><span class='nam'>file_credentials</span><span class='op'>[</span><span class='str'>&#39;username&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t644' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>file_credentials</span><span class='op'>[</span><span class='str'>&#39;api_key&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t645' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t646' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyLocalCredentialsError</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t647' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t648' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>kwargs</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>dumps</span><span class='op'>(</span><span class='nam'>dict</span><span class='op'>(</span><span class='nam'>filename</span><span class='op'>=</span><span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;filename&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t649' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>fileopt</span><span class='op'>=</span><span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;fileopt&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t650' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>world_readable</span><span class='op'>=</span><span class='nam'>plot_options</span><span class='op'>[</span><span class='str'>&#39;world_readable&#39;</span><span class='op'>]</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t651' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>layout</span><span class='op'>=</span><span class='nam'>fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span> <span class='key'>if</span> <span class='str'>&#39;layout&#39;</span> <span class='key'>in</span> <span class='nam'>fig</span><span class='strut'>&nbsp;</span></p>
+<p id='t652' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='key'>else</span> <span class='op'>{</span><span class='op'>}</span><span class='op'>)</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t653' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>cls</span><span class='op'>=</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>_plotlyJSONEncoder</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t654' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t655' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t656' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>payload</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='nam'>platform</span><span class='op'>=</span><span class='str'>&#39;python&#39;</span><span class='op'>,</span> <span class='com'># TODO: It&#39;d be cool to expose the platform for RaspPi and others</span><span class='strut'>&nbsp;</span></p>
+<p id='t657' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>version</span><span class='op'>=</span><span class='nam'>version</span><span class='op'>.</span><span class='nam'>__version__</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t658' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>args</span><span class='op'>=</span><span class='nam'>data</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t659' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>un</span><span class='op'>=</span><span class='nam'>username</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t660' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>key</span><span class='op'>=</span><span class='nam'>api_key</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t661' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>origin</span><span class='op'>=</span><span class='str'>&#39;plot&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t662' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>kwargs</span><span class='op'>=</span><span class='nam'>kwargs</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
 <p id='t663' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t664' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>r</span> <span class='op'>=</span> <span class='nam'>requests</span><span class='op'>.</span><span class='nam'>post</span><span class='op'>(</span><span class='nam'>url</span><span class='op'>,</span> <span class='nam'>data</span><span class='op'>=</span><span class='nam'>payload</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t665' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>r</span><span class='op'>.</span><span class='nam'>raise_for_status</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t666' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>r</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>r</span><span class='op'>.</span><span class='nam'>text</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t667' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;error&#39;</span> <span class='key'>in</span> <span class='nam'>r</span> <span class='key'>and</span> <span class='nam'>r</span><span class='op'>[</span><span class='str'>&#39;error&#39;</span><span class='op'>]</span> <span class='op'>!=</span> <span class='str'>&#39;&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t668' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>print</span><span class='op'>(</span><span class='op'>(</span><span class='nam'>r</span><span class='op'>[</span><span class='str'>&#39;error&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t669' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;warning&#39;</span> <span class='key'>in</span> <span class='nam'>r</span> <span class='key'>and</span> <span class='nam'>r</span><span class='op'>[</span><span class='str'>&#39;warning&#39;</span><span class='op'>]</span> <span class='op'>!=</span> <span class='str'>&#39;&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t670' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='nam'>r</span><span class='op'>[</span><span class='str'>&#39;warning&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t671' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;message&#39;</span> <span class='key'>in</span> <span class='nam'>r</span> <span class='key'>and</span> <span class='nam'>r</span><span class='op'>[</span><span class='str'>&#39;message&#39;</span><span class='op'>]</span> <span class='op'>!=</span> <span class='str'>&#39;&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t672' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>print</span><span class='op'>(</span><span class='op'>(</span><span class='nam'>r</span><span class='op'>[</span><span class='str'>&#39;message&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t673' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t674' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>r</span><span class='strut'>&nbsp;</span></p>
+<p id='t664' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>url</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>[</span><span class='str'>&#39;plotly_domain&#39;</span><span class='op'>]</span> <span class='op'>+</span> <span class='str'>&quot;/clientresp&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t665' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t666' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>r</span> <span class='op'>=</span> <span class='nam'>requests</span><span class='op'>.</span><span class='nam'>post</span><span class='op'>(</span><span class='nam'>url</span><span class='op'>,</span> <span class='nam'>data</span><span class='op'>=</span><span class='nam'>payload</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t667' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>r</span><span class='op'>.</span><span class='nam'>raise_for_status</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t668' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>r</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>loads</span><span class='op'>(</span><span class='nam'>r</span><span class='op'>.</span><span class='nam'>text</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t669' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;error&#39;</span> <span class='key'>in</span> <span class='nam'>r</span> <span class='key'>and</span> <span class='nam'>r</span><span class='op'>[</span><span class='str'>&#39;error&#39;</span><span class='op'>]</span> <span class='op'>!=</span> <span class='str'>&#39;&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t670' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>print</span><span class='op'>(</span><span class='op'>(</span><span class='nam'>r</span><span class='op'>[</span><span class='str'>&#39;error&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t671' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;warning&#39;</span> <span class='key'>in</span> <span class='nam'>r</span> <span class='key'>and</span> <span class='nam'>r</span><span class='op'>[</span><span class='str'>&#39;warning&#39;</span><span class='op'>]</span> <span class='op'>!=</span> <span class='str'>&#39;&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t672' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='nam'>r</span><span class='op'>[</span><span class='str'>&#39;warning&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t673' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;message&#39;</span> <span class='key'>in</span> <span class='nam'>r</span> <span class='key'>and</span> <span class='nam'>r</span><span class='op'>[</span><span class='str'>&#39;message&#39;</span><span class='op'>]</span> <span class='op'>!=</span> <span class='str'>&#39;&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t674' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>print</span><span class='op'>(</span><span class='op'>(</span><span class='nam'>r</span><span class='op'>[</span><span class='str'>&#39;message&#39;</span><span class='op'>]</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
 <p id='t675' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t676' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t677' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>_validation_key_logic</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t678' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>creds_on_file</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_credentials_file</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t679' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;username&#39;</span> <span class='key'>in</span> <span class='nam'>_credentials</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t680' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>username</span> <span class='op'>=</span> <span class='nam'>_credentials</span><span class='op'>[</span><span class='str'>&#39;username&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t681' class='stm mis'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='str'>&#39;username&#39;</span> <span class='key'>in</span> <span class='nam'>creds_on_file</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t682' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>username</span> <span class='op'>=</span> <span class='nam'>creds_on_file</span><span class='op'>[</span><span class='str'>&#39;username&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t683' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t684' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>username</span> <span class='op'>=</span> <span class='nam'>None</span><span class='strut'>&nbsp;</span></p>
-<p id='t685' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;api_key&#39;</span> <span class='key'>in</span> <span class='nam'>_credentials</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t686' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>api_key</span> <span class='op'>=</span> <span class='nam'>_credentials</span><span class='op'>[</span><span class='str'>&#39;api_key&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t687' class='stm mis'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='str'>&#39;api_key&#39;</span> <span class='key'>in</span> <span class='nam'>creds_on_file</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t688' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>api_key</span> <span class='op'>=</span> <span class='nam'>creds_on_file</span><span class='op'>[</span><span class='str'>&#39;api_key&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t689' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t690' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>api_key</span> <span class='op'>=</span> <span class='nam'>None</span><span class='strut'>&nbsp;</span></p>
-<p id='t691' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>username</span> <span class='key'>is</span> <span class='nam'>None</span> <span class='key'>or</span> <span class='nam'>api_key</span> <span class='key'>is</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t692' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyLocalCredentialsError</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t693' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>return</span> <span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t676' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>r</span><span class='strut'>&nbsp;</span></p>
+<p id='t677' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t678' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t679' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>_validation_key_logic</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t680' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>creds_on_file</span> <span class='op'>=</span> <span class='nam'>tools</span><span class='op'>.</span><span class='nam'>get_credentials_file</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t681' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;username&#39;</span> <span class='key'>in</span> <span class='nam'>_credentials</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t682' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>username</span> <span class='op'>=</span> <span class='nam'>_credentials</span><span class='op'>[</span><span class='str'>&#39;username&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t683' class='stm mis'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='str'>&#39;username&#39;</span> <span class='key'>in</span> <span class='nam'>creds_on_file</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t684' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>username</span> <span class='op'>=</span> <span class='nam'>creds_on_file</span><span class='op'>[</span><span class='str'>&#39;username&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t685' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t686' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>username</span> <span class='op'>=</span> <span class='nam'>None</span><span class='strut'>&nbsp;</span></p>
+<p id='t687' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;api_key&#39;</span> <span class='key'>in</span> <span class='nam'>_credentials</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t688' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>api_key</span> <span class='op'>=</span> <span class='nam'>_credentials</span><span class='op'>[</span><span class='str'>&#39;api_key&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t689' class='stm mis'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='str'>&#39;api_key&#39;</span> <span class='key'>in</span> <span class='nam'>creds_on_file</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t690' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>api_key</span> <span class='op'>=</span> <span class='nam'>creds_on_file</span><span class='op'>[</span><span class='str'>&#39;api_key&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t691' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t692' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>api_key</span> <span class='op'>=</span> <span class='nam'>None</span><span class='strut'>&nbsp;</span></p>
+<p id='t693' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>username</span> <span class='key'>is</span> <span class='nam'>None</span> <span class='key'>or</span> <span class='nam'>api_key</span> <span class='key'>is</span> <span class='nam'>None</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t694' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyLocalCredentialsError</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t695' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>return</span> <span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
                 
             </td>
         </tr>
diff --git a/plotly/tests/coverage/plotly_tools.html b/plotly/tests/coverage/plotly_tools.html
--- a/plotly/tests/coverage/plotly_tools.html
+++ b/plotly/tests/coverage/plotly_tools.html
@@ -5,7 +5,7 @@
     
     
     <meta http-equiv='X-UA-Compatible' content='IE=emulateIE7' />
-    <title>Coverage for plotly/tools: 43%</title>
+    <title>Coverage for plotly/tools: 78%</title>
     <link rel='stylesheet' href='style.css' type='text/css'>
     
     <script type='text/javascript' src='jquery.min.js'></script>
@@ -21,13 +21,13 @@
 <div id='header'>
     <div class='content'>
         <h1>Coverage for <b>plotly/tools</b> :
-            <span class='pc_cov'>43%</span>
+            <span class='pc_cov'>78%</span>
         </h1>
         <img id='keyboard_icon' src='keybd_closed.png'>
         <h2 class='stats'>
-            231 statements &nbsp;
-            <span class='run hide_run shortkey_r button_toggle_run'>99 run</span>
-            <span class='mis shortkey_m button_toggle_mis'>132 missing</span>
+            233 statements &nbsp;
+            <span class='run hide_run shortkey_r button_toggle_run'>182 run</span>
+            <span class='mis shortkey_m button_toggle_mis'>51 missing</span>
             <span class='exc shortkey_x button_toggle_exc'>0 excluded</span>
             
         </h2>
@@ -71,79 +71,79 @@ <h2 class='stats'>
 <p id='n8' class='pln'><a href='#n8'>8</a></p>
 <p id='n9' class='pln'><a href='#n9'>9</a></p>
 <p id='n10' class='stm run hide_run'><a href='#n10'>10</a></p>
-<p id='n11' class='stm run hide_run'><a href='#n11'>11</a></p>
+<p id='n11' class='pln'><a href='#n11'>11</a></p>
 <p id='n12' class='stm run hide_run'><a href='#n12'>12</a></p>
-<p id='n13' class='pln'><a href='#n13'>13</a></p>
+<p id='n13' class='stm run hide_run'><a href='#n13'>13</a></p>
 <p id='n14' class='stm run hide_run'><a href='#n14'>14</a></p>
 <p id='n15' class='stm run hide_run'><a href='#n15'>15</a></p>
 <p id='n16' class='pln'><a href='#n16'>16</a></p>
-<p id='n17' class='pln'><a href='#n17'>17</a></p>
-<p id='n18' class='pln'><a href='#n18'>18</a></p>
+<p id='n17' class='stm run hide_run'><a href='#n17'>17</a></p>
+<p id='n18' class='stm run hide_run'><a href='#n18'>18</a></p>
 <p id='n19' class='pln'><a href='#n19'>19</a></p>
-<p id='n20' class='pln'><a href='#n20'>20</a></p>
-<p id='n21' class='pln'><a href='#n21'>21</a></p>
+<p id='n20' class='stm run hide_run'><a href='#n20'>20</a></p>
+<p id='n21' class='stm run hide_run'><a href='#n21'>21</a></p>
 <p id='n22' class='pln'><a href='#n22'>22</a></p>
-<p id='n23' class='stm run hide_run'><a href='#n23'>23</a></p>
+<p id='n23' class='pln'><a href='#n23'>23</a></p>
 <p id='n24' class='stm run hide_run'><a href='#n24'>24</a></p>
-<p id='n25' class='pln'><a href='#n25'>25</a></p>
+<p id='n25' class='stm mis'><a href='#n25'>25</a></p>
 <p id='n26' class='stm run hide_run'><a href='#n26'>26</a></p>
-<p id='n27' class='stm mis'><a href='#n27'>27</a></p>
+<p id='n27' class='pln'><a href='#n27'>27</a></p>
 <p id='n28' class='stm run hide_run'><a href='#n28'>28</a></p>
-<p id='n29' class='pln'><a href='#n29'>29</a></p>
-<p id='n30' class='stm run hide_run'><a href='#n30'>30</a></p>
-<p id='n31' class='stm run hide_run'><a href='#n31'>31</a></p>
-<p id='n32' class='stm mis'><a href='#n32'>32</a></p>
-<p id='n33' class='stm mis'><a href='#n33'>33</a></p>
-<p id='n34' class='pln'><a href='#n34'>34</a></p>
+<p id='n29' class='stm run hide_run'><a href='#n29'>29</a></p>
+<p id='n30' class='stm mis'><a href='#n30'>30</a></p>
+<p id='n31' class='stm mis'><a href='#n31'>31</a></p>
+<p id='n32' class='pln'><a href='#n32'>32</a></p>
+<p id='n33' class='stm run hide_run'><a href='#n33'>33</a></p>
+<p id='n34' class='stm run hide_run'><a href='#n34'>34</a></p>
 <p id='n35' class='stm run hide_run'><a href='#n35'>35</a></p>
 <p id='n36' class='stm run hide_run'><a href='#n36'>36</a></p>
 <p id='n37' class='stm run hide_run'><a href='#n37'>37</a></p>
-<p id='n38' class='stm run hide_run'><a href='#n38'>38</a></p>
-<p id='n39' class='stm run hide_run'><a href='#n39'>39</a></p>
-<p id='n40' class='pln'><a href='#n40'>40</a></p>
+<p id='n38' class='pln'><a href='#n38'>38</a></p>
+<p id='n39' class='pln'><a href='#n39'>39</a></p>
+<p id='n40' class='stm run hide_run'><a href='#n40'>40</a></p>
 <p id='n41' class='pln'><a href='#n41'>41</a></p>
-<p id='n42' class='stm run hide_run'><a href='#n42'>42</a></p>
+<p id='n42' class='pln'><a href='#n42'>42</a></p>
 <p id='n43' class='pln'><a href='#n43'>43</a></p>
 <p id='n44' class='pln'><a href='#n44'>44</a></p>
 <p id='n45' class='pln'><a href='#n45'>45</a></p>
-<p id='n46' class='pln'><a href='#n46'>46</a></p>
-<p id='n47' class='pln'><a href='#n47'>47</a></p>
+<p id='n46' class='stm run hide_run'><a href='#n46'>46</a></p>
+<p id='n47' class='stm run hide_run'><a href='#n47'>47</a></p>
 <p id='n48' class='stm run hide_run'><a href='#n48'>48</a></p>
 <p id='n49' class='stm run hide_run'><a href='#n49'>49</a></p>
-<p id='n50' class='stm run hide_run'><a href='#n50'>50</a></p>
+<p id='n50' class='stm mis'><a href='#n50'>50</a></p>
 <p id='n51' class='stm run hide_run'><a href='#n51'>51</a></p>
-<p id='n52' class='stm mis'><a href='#n52'>52</a></p>
+<p id='n52' class='stm run hide_run'><a href='#n52'>52</a></p>
 <p id='n53' class='stm run hide_run'><a href='#n53'>53</a></p>
 <p id='n54' class='stm run hide_run'><a href='#n54'>54</a></p>
 <p id='n55' class='stm run hide_run'><a href='#n55'>55</a></p>
-<p id='n56' class='stm run hide_run'><a href='#n56'>56</a></p>
-<p id='n57' class='stm run hide_run'><a href='#n57'>57</a></p>
-<p id='n58' class='stm mis'><a href='#n58'>58</a></p>
-<p id='n59' class='stm mis'><a href='#n59'>59</a></p>
-<p id='n60' class='pln'><a href='#n60'>60</a></p>
-<p id='n61' class='pln'><a href='#n61'>61</a></p>
-<p id='n62' class='stm run hide_run'><a href='#n62'>62</a></p>
-<p id='n63' class='stm mis'><a href='#n63'>63</a></p>
-<p id='n64' class='pln'><a href='#n64'>64</a></p>
+<p id='n56' class='stm mis'><a href='#n56'>56</a></p>
+<p id='n57' class='stm mis'><a href='#n57'>57</a></p>
+<p id='n58' class='pln'><a href='#n58'>58</a></p>
+<p id='n59' class='pln'><a href='#n59'>59</a></p>
+<p id='n60' class='stm run hide_run'><a href='#n60'>60</a></p>
+<p id='n61' class='stm mis'><a href='#n61'>61</a></p>
+<p id='n62' class='pln'><a href='#n62'>62</a></p>
+<p id='n63' class='pln'><a href='#n63'>63</a></p>
+<p id='n64' class='stm run hide_run'><a href='#n64'>64</a></p>
 <p id='n65' class='pln'><a href='#n65'>65</a></p>
 <p id='n66' class='stm run hide_run'><a href='#n66'>66</a></p>
-<p id='n67' class='pln'><a href='#n67'>67</a></p>
-<p id='n68' class='stm run hide_run'><a href='#n68'>68</a></p>
+<p id='n67' class='stm run hide_run'><a href='#n67'>67</a></p>
+<p id='n68' class='stm mis'><a href='#n68'>68</a></p>
 <p id='n69' class='stm run hide_run'><a href='#n69'>69</a></p>
-<p id='n70' class='stm mis'><a href='#n70'>70</a></p>
+<p id='n70' class='stm run hide_run'><a href='#n70'>70</a></p>
 <p id='n71' class='stm run hide_run'><a href='#n71'>71</a></p>
-<p id='n72' class='stm run hide_run'><a href='#n72'>72</a></p>
+<p id='n72' class='pln'><a href='#n72'>72</a></p>
 <p id='n73' class='stm run hide_run'><a href='#n73'>73</a></p>
-<p id='n74' class='pln'><a href='#n74'>74</a></p>
+<p id='n74' class='stm run hide_run'><a href='#n74'>74</a></p>
 <p id='n75' class='stm run hide_run'><a href='#n75'>75</a></p>
-<p id='n76' class='stm mis'><a href='#n76'>76</a></p>
+<p id='n76' class='stm run hide_run'><a href='#n76'>76</a></p>
 <p id='n77' class='stm run hide_run'><a href='#n77'>77</a></p>
-<p id='n78' class='stm run hide_run'><a href='#n78'>78</a></p>
+<p id='n78' class='stm mis'><a href='#n78'>78</a></p>
 <p id='n79' class='stm run hide_run'><a href='#n79'>79</a></p>
-<p id='n80' class='stm mis'><a href='#n80'>80</a></p>
-<p id='n81' class='stm run hide_run'><a href='#n81'>81</a></p>
+<p id='n80' class='pln'><a href='#n80'>80</a></p>
+<p id='n81' class='stm mis'><a href='#n81'>81</a></p>
 <p id='n82' class='pln'><a href='#n82'>82</a></p>
-<p id='n83' class='stm mis'><a href='#n83'>83</a></p>
+<p id='n83' class='pln'><a href='#n83'>83</a></p>
 <p id='n84' class='pln'><a href='#n84'>84</a></p>
 <p id='n85' class='pln'><a href='#n85'>85</a></p>
 <p id='n86' class='pln'><a href='#n86'>86</a></p>
@@ -152,176 +152,176 @@ <h2 class='stats'>
 <p id='n89' class='pln'><a href='#n89'>89</a></p>
 <p id='n90' class='pln'><a href='#n90'>90</a></p>
 <p id='n91' class='pln'><a href='#n91'>91</a></p>
-<p id='n92' class='pln'><a href='#n92'>92</a></p>
+<p id='n92' class='stm run hide_run'><a href='#n92'>92</a></p>
 <p id='n93' class='pln'><a href='#n93'>93</a></p>
-<p id='n94' class='stm run hide_run'><a href='#n94'>94</a></p>
+<p id='n94' class='pln'><a href='#n94'>94</a></p>
 <p id='n95' class='pln'><a href='#n95'>95</a></p>
-<p id='n96' class='pln'><a href='#n96'>96</a></p>
-<p id='n97' class='pln'><a href='#n97'>97</a></p>
-<p id='n98' class='stm mis'><a href='#n98'>98</a></p>
-<p id='n99' class='stm mis'><a href='#n99'>99</a></p>
-<p id='n100' class='pln'><a href='#n100'>100</a></p>
-<p id='n101' class='stm mis'><a href='#n101'>101</a></p>
-<p id='n102' class='stm mis'><a href='#n102'>102</a></p>
-<p id='n103' class='stm mis'><a href='#n103'>103</a></p>
-<p id='n104' class='stm mis'><a href='#n104'>104</a></p>
-<p id='n105' class='stm mis'><a href='#n105'>105</a></p>
-<p id='n106' class='stm mis'><a href='#n106'>106</a></p>
-<p id='n107' class='stm mis'><a href='#n107'>107</a></p>
-<p id='n108' class='stm mis'><a href='#n108'>108</a></p>
-<p id='n109' class='stm mis'><a href='#n109'>109</a></p>
-<p id='n110' class='stm mis'><a href='#n110'>110</a></p>
-<p id='n111' class='pln'><a href='#n111'>111</a></p>
+<p id='n96' class='stm run hide_run'><a href='#n96'>96</a></p>
+<p id='n97' class='stm mis'><a href='#n97'>97</a></p>
+<p id='n98' class='pln'><a href='#n98'>98</a></p>
+<p id='n99' class='stm run hide_run'><a href='#n99'>99</a></p>
+<p id='n100' class='stm run hide_run'><a href='#n100'>100</a></p>
+<p id='n101' class='stm run hide_run'><a href='#n101'>101</a></p>
+<p id='n102' class='stm run hide_run'><a href='#n102'>102</a></p>
+<p id='n103' class='stm run hide_run'><a href='#n103'>103</a></p>
+<p id='n104' class='stm run hide_run'><a href='#n104'>104</a></p>
+<p id='n105' class='stm run hide_run'><a href='#n105'>105</a></p>
+<p id='n106' class='stm run hide_run'><a href='#n106'>106</a></p>
+<p id='n107' class='stm run hide_run'><a href='#n107'>107</a></p>
+<p id='n108' class='stm run hide_run'><a href='#n108'>108</a></p>
+<p id='n109' class='pln'><a href='#n109'>109</a></p>
+<p id='n110' class='pln'><a href='#n110'>110</a></p>
+<p id='n111' class='stm run hide_run'><a href='#n111'>111</a></p>
 <p id='n112' class='pln'><a href='#n112'>112</a></p>
-<p id='n113' class='stm run hide_run'><a href='#n113'>113</a></p>
+<p id='n113' class='pln'><a href='#n113'>113</a></p>
 <p id='n114' class='pln'><a href='#n114'>114</a></p>
 <p id='n115' class='pln'><a href='#n115'>115</a></p>
 <p id='n116' class='pln'><a href='#n116'>116</a></p>
 <p id='n117' class='pln'><a href='#n117'>117</a></p>
 <p id='n118' class='pln'><a href='#n118'>118</a></p>
 <p id='n119' class='pln'><a href='#n119'>119</a></p>
-<p id='n120' class='pln'><a href='#n120'>120</a></p>
-<p id='n121' class='pln'><a href='#n121'>121</a></p>
+<p id='n120' class='stm run hide_run'><a href='#n120'>120</a></p>
+<p id='n121' class='stm run hide_run'><a href='#n121'>121</a></p>
 <p id='n122' class='stm run hide_run'><a href='#n122'>122</a></p>
-<p id='n123' class='stm run hide_run'><a href='#n123'>123</a></p>
-<p id='n124' class='stm run hide_run'><a href='#n124'>124</a></p>
+<p id='n123' class='pln'><a href='#n123'>123</a></p>
+<p id='n124' class='stm mis'><a href='#n124'>124</a></p>
 <p id='n125' class='pln'><a href='#n125'>125</a></p>
-<p id='n126' class='stm mis'><a href='#n126'>126</a></p>
-<p id='n127' class='pln'><a href='#n127'>127</a></p>
-<p id='n128' class='pln'><a href='#n128'>128</a></p>
+<p id='n126' class='pln'><a href='#n126'>126</a></p>
+<p id='n127' class='stm run hide_run'><a href='#n127'>127</a></p>
+<p id='n128' class='stm run hide_run'><a href='#n128'>128</a></p>
 <p id='n129' class='stm run hide_run'><a href='#n129'>129</a></p>
-<p id='n130' class='stm mis'><a href='#n130'>130</a></p>
-<p id='n131' class='stm mis'><a href='#n131'>131</a></p>
-<p id='n132' class='stm mis'><a href='#n132'>132</a></p>
-<p id='n133' class='stm mis'><a href='#n133'>133</a></p>
+<p id='n130' class='stm run hide_run'><a href='#n130'>130</a></p>
+<p id='n131' class='stm run hide_run'><a href='#n131'>131</a></p>
+<p id='n132' class='pln'><a href='#n132'>132</a></p>
+<p id='n133' class='pln'><a href='#n133'>133</a></p>
 <p id='n134' class='pln'><a href='#n134'>134</a></p>
 <p id='n135' class='pln'><a href='#n135'>135</a></p>
-<p id='n136' class='pln'><a href='#n136'>136</a></p>
+<p id='n136' class='stm run hide_run'><a href='#n136'>136</a></p>
 <p id='n137' class='pln'><a href='#n137'>137</a></p>
 <p id='n138' class='pln'><a href='#n138'>138</a></p>
 <p id='n139' class='pln'><a href='#n139'>139</a></p>
-<p id='n140' class='pln'><a href='#n140'>140</a></p>
-<p id='n141' class='pln'><a href='#n141'>141</a></p>
+<p id='n140' class='stm run hide_run'><a href='#n140'>140</a></p>
+<p id='n141' class='stm mis'><a href='#n141'>141</a></p>
 <p id='n142' class='pln'><a href='#n142'>142</a></p>
-<p id='n143' class='pln'><a href='#n143'>143</a></p>
-<p id='n144' class='pln'><a href='#n144'>144</a></p>
-<p id='n145' class='pln'><a href='#n145'>145</a></p>
-<p id='n146' class='pln'><a href='#n146'>146</a></p>
-<p id='n147' class='pln'><a href='#n147'>147</a></p>
-<p id='n148' class='pln'><a href='#n148'>148</a></p>
-<p id='n149' class='pln'><a href='#n149'>149</a></p>
-<p id='n150' class='pln'><a href='#n150'>150</a></p>
+<p id='n143' class='stm run hide_run'><a href='#n143'>143</a></p>
+<p id='n144' class='stm run hide_run'><a href='#n144'>144</a></p>
+<p id='n145' class='stm run hide_run'><a href='#n145'>145</a></p>
+<p id='n146' class='stm run hide_run'><a href='#n146'>146</a></p>
+<p id='n147' class='stm run hide_run'><a href='#n147'>147</a></p>
+<p id='n148' class='stm run hide_run'><a href='#n148'>148</a></p>
+<p id='n149' class='stm run hide_run'><a href='#n149'>149</a></p>
+<p id='n150' class='stm run hide_run'><a href='#n150'>150</a></p>
 <p id='n151' class='pln'><a href='#n151'>151</a></p>
 <p id='n152' class='pln'><a href='#n152'>152</a></p>
-<p id='n153' class='pln'><a href='#n153'>153</a></p>
-<p id='n154' class='stm run hide_run'><a href='#n154'>154</a></p>
+<p id='n153' class='stm run hide_run'><a href='#n153'>153</a></p>
+<p id='n154' class='pln'><a href='#n154'>154</a></p>
 <p id='n155' class='pln'><a href='#n155'>155</a></p>
 <p id='n156' class='pln'><a href='#n156'>156</a></p>
 <p id='n157' class='pln'><a href='#n157'>157</a></p>
-<p id='n158' class='stm mis'><a href='#n158'>158</a></p>
-<p id='n159' class='stm mis'><a href='#n159'>159</a></p>
+<p id='n158' class='pln'><a href='#n158'>158</a></p>
+<p id='n159' class='pln'><a href='#n159'>159</a></p>
 <p id='n160' class='pln'><a href='#n160'>160</a></p>
-<p id='n161' class='stm mis'><a href='#n161'>161</a></p>
-<p id='n162' class='stm mis'><a href='#n162'>162</a></p>
-<p id='n163' class='stm mis'><a href='#n163'>163</a></p>
-<p id='n164' class='stm mis'><a href='#n164'>164</a></p>
-<p id='n165' class='stm mis'><a href='#n165'>165</a></p>
+<p id='n161' class='pln'><a href='#n161'>161</a></p>
+<p id='n162' class='stm run hide_run'><a href='#n162'>162</a></p>
+<p id='n163' class='stm run hide_run'><a href='#n163'>163</a></p>
+<p id='n164' class='stm run hide_run'><a href='#n164'>164</a></p>
+<p id='n165' class='pln'><a href='#n165'>165</a></p>
 <p id='n166' class='stm mis'><a href='#n166'>166</a></p>
-<p id='n167' class='stm mis'><a href='#n167'>167</a></p>
-<p id='n168' class='stm mis'><a href='#n168'>168</a></p>
-<p id='n169' class='pln'><a href='#n169'>169</a></p>
-<p id='n170' class='pln'><a href='#n170'>170</a></p>
+<p id='n167' class='pln'><a href='#n167'>167</a></p>
+<p id='n168' class='pln'><a href='#n168'>168</a></p>
+<p id='n169' class='stm run hide_run'><a href='#n169'>169</a></p>
+<p id='n170' class='stm run hide_run'><a href='#n170'>170</a></p>
 <p id='n171' class='stm run hide_run'><a href='#n171'>171</a></p>
-<p id='n172' class='pln'><a href='#n172'>172</a></p>
-<p id='n173' class='pln'><a href='#n173'>173</a></p>
+<p id='n172' class='stm run hide_run'><a href='#n172'>172</a></p>
+<p id='n173' class='stm run hide_run'><a href='#n173'>173</a></p>
 <p id='n174' class='pln'><a href='#n174'>174</a></p>
 <p id='n175' class='pln'><a href='#n175'>175</a></p>
 <p id='n176' class='pln'><a href='#n176'>176</a></p>
 <p id='n177' class='pln'><a href='#n177'>177</a></p>
-<p id='n178' class='pln'><a href='#n178'>178</a></p>
+<p id='n178' class='stm run hide_run'><a href='#n178'>178</a></p>
 <p id='n179' class='pln'><a href='#n179'>179</a></p>
-<p id='n180' class='stm run hide_run'><a href='#n180'>180</a></p>
-<p id='n181' class='stm run hide_run'><a href='#n181'>181</a></p>
-<p id='n182' class='stm run hide_run'><a href='#n182'>182</a></p>
+<p id='n180' class='pln'><a href='#n180'>180</a></p>
+<p id='n181' class='pln'><a href='#n181'>181</a></p>
+<p id='n182' class='pln'><a href='#n182'>182</a></p>
 <p id='n183' class='pln'><a href='#n183'>183</a></p>
-<p id='n184' class='stm mis'><a href='#n184'>184</a></p>
+<p id='n184' class='pln'><a href='#n184'>184</a></p>
 <p id='n185' class='pln'><a href='#n185'>185</a></p>
 <p id='n186' class='pln'><a href='#n186'>186</a></p>
-<p id='n187' class='stm run hide_run'><a href='#n187'>187</a></p>
-<p id='n188' class='stm mis'><a href='#n188'>188</a></p>
-<p id='n189' class='stm mis'><a href='#n189'>189</a></p>
-<p id='n190' class='stm mis'><a href='#n190'>190</a></p>
-<p id='n191' class='stm mis'><a href='#n191'>191</a></p>
+<p id='n187' class='pln'><a href='#n187'>187</a></p>
+<p id='n188' class='pln'><a href='#n188'>188</a></p>
+<p id='n189' class='pln'><a href='#n189'>189</a></p>
+<p id='n190' class='pln'><a href='#n190'>190</a></p>
+<p id='n191' class='pln'><a href='#n191'>191</a></p>
 <p id='n192' class='pln'><a href='#n192'>192</a></p>
 <p id='n193' class='pln'><a href='#n193'>193</a></p>
 <p id='n194' class='pln'><a href='#n194'>194</a></p>
 <p id='n195' class='pln'><a href='#n195'>195</a></p>
-<p id='n196' class='stm run hide_run'><a href='#n196'>196</a></p>
+<p id='n196' class='pln'><a href='#n196'>196</a></p>
 <p id='n197' class='pln'><a href='#n197'>197</a></p>
 <p id='n198' class='pln'><a href='#n198'>198</a></p>
 <p id='n199' class='pln'><a href='#n199'>199</a></p>
-<p id='n200' class='pln'><a href='#n200'>200</a></p>
-<p id='n201' class='pln'><a href='#n201'>201</a></p>
-<p id='n202' class='pln'><a href='#n202'>202</a></p>
-<p id='n203' class='pln'><a href='#n203'>203</a></p>
-<p id='n204' class='pln'><a href='#n204'>204</a></p>
-<p id='n205' class='pln'><a href='#n205'>205</a></p>
+<p id='n200' class='stm run hide_run'><a href='#n200'>200</a></p>
+<p id='n201' class='stm run hide_run'><a href='#n201'>201</a></p>
+<p id='n202' class='stm run hide_run'><a href='#n202'>202</a></p>
+<p id='n203' class='stm run hide_run'><a href='#n203'>203</a></p>
+<p id='n204' class='stm run hide_run'><a href='#n204'>204</a></p>
+<p id='n205' class='stm mis'><a href='#n205'>205</a></p>
 <p id='n206' class='pln'><a href='#n206'>206</a></p>
 <p id='n207' class='pln'><a href='#n207'>207</a></p>
 <p id='n208' class='pln'><a href='#n208'>208</a></p>
 <p id='n209' class='pln'><a href='#n209'>209</a></p>
 <p id='n210' class='pln'><a href='#n210'>210</a></p>
-<p id='n211' class='pln'><a href='#n211'>211</a></p>
-<p id='n212' class='pln'><a href='#n212'>212</a></p>
-<p id='n213' class='pln'><a href='#n213'>213</a></p>
+<p id='n211' class='stm run hide_run'><a href='#n211'>211</a></p>
+<p id='n212' class='stm run hide_run'><a href='#n212'>212</a></p>
+<p id='n213' class='stm run hide_run'><a href='#n213'>213</a></p>
 <p id='n214' class='pln'><a href='#n214'>214</a></p>
-<p id='n215' class='pln'><a href='#n215'>215</a></p>
-<p id='n216' class='pln'><a href='#n216'>216</a></p>
+<p id='n215' class='stm mis'><a href='#n215'>215</a></p>
+<p id='n216' class='stm run hide_run'><a href='#n216'>216</a></p>
 <p id='n217' class='pln'><a href='#n217'>217</a></p>
-<p id='n218' class='stm mis'><a href='#n218'>218</a></p>
-<p id='n219' class='stm mis'><a href='#n219'>219</a></p>
-<p id='n220' class='stm mis'><a href='#n220'>220</a></p>
-<p id='n221' class='stm mis'><a href='#n221'>221</a></p>
-<p id='n222' class='stm mis'><a href='#n222'>222</a></p>
-<p id='n223' class='stm mis'><a href='#n223'>223</a></p>
+<p id='n218' class='stm run hide_run'><a href='#n218'>218</a></p>
+<p id='n219' class='stm run hide_run'><a href='#n219'>219</a></p>
+<p id='n220' class='stm run hide_run'><a href='#n220'>220</a></p>
+<p id='n221' class='stm run hide_run'><a href='#n221'>221</a></p>
+<p id='n222' class='pln'><a href='#n222'>222</a></p>
+<p id='n223' class='pln'><a href='#n223'>223</a></p>
 <p id='n224' class='pln'><a href='#n224'>224</a></p>
 <p id='n225' class='pln'><a href='#n225'>225</a></p>
 <p id='n226' class='pln'><a href='#n226'>226</a></p>
-<p id='n227' class='pln'><a href='#n227'>227</a></p>
-<p id='n228' class='pln'><a href='#n228'>228</a></p>
-<p id='n229' class='stm mis'><a href='#n229'>229</a></p>
-<p id='n230' class='stm mis'><a href='#n230'>230</a></p>
-<p id='n231' class='stm mis'><a href='#n231'>231</a></p>
-<p id='n232' class='pln'><a href='#n232'>232</a></p>
-<p id='n233' class='stm mis'><a href='#n233'>233</a></p>
-<p id='n234' class='stm mis'><a href='#n234'>234</a></p>
+<p id='n227' class='stm run hide_run'><a href='#n227'>227</a></p>
+<p id='n228' class='stm mis'><a href='#n228'>228</a></p>
+<p id='n229' class='pln'><a href='#n229'>229</a></p>
+<p id='n230' class='pln'><a href='#n230'>230</a></p>
+<p id='n231' class='stm run hide_run'><a href='#n231'>231</a></p>
+<p id='n232' class='stm mis'><a href='#n232'>232</a></p>
+<p id='n233' class='pln'><a href='#n233'>233</a></p>
+<p id='n234' class='pln'><a href='#n234'>234</a></p>
 <p id='n235' class='pln'><a href='#n235'>235</a></p>
-<p id='n236' class='stm mis'><a href='#n236'>236</a></p>
-<p id='n237' class='stm mis'><a href='#n237'>237</a></p>
-<p id='n238' class='stm mis'><a href='#n238'>238</a></p>
-<p id='n239' class='stm mis'><a href='#n239'>239</a></p>
+<p id='n236' class='pln'><a href='#n236'>236</a></p>
+<p id='n237' class='pln'><a href='#n237'>237</a></p>
+<p id='n238' class='pln'><a href='#n238'>238</a></p>
+<p id='n239' class='pln'><a href='#n239'>239</a></p>
 <p id='n240' class='pln'><a href='#n240'>240</a></p>
 <p id='n241' class='pln'><a href='#n241'>241</a></p>
 <p id='n242' class='pln'><a href='#n242'>242</a></p>
-<p id='n243' class='pln'><a href='#n243'>243</a></p>
+<p id='n243' class='stm run hide_run'><a href='#n243'>243</a></p>
 <p id='n244' class='pln'><a href='#n244'>244</a></p>
-<p id='n245' class='stm mis'><a href='#n245'>245</a></p>
-<p id='n246' class='stm mis'><a href='#n246'>246</a></p>
+<p id='n245' class='pln'><a href='#n245'>245</a></p>
+<p id='n246' class='pln'><a href='#n246'>246</a></p>
 <p id='n247' class='pln'><a href='#n247'>247</a></p>
 <p id='n248' class='pln'><a href='#n248'>248</a></p>
-<p id='n249' class='stm mis'><a href='#n249'>249</a></p>
-<p id='n250' class='stm mis'><a href='#n250'>250</a></p>
+<p id='n249' class='pln'><a href='#n249'>249</a></p>
+<p id='n250' class='pln'><a href='#n250'>250</a></p>
 <p id='n251' class='pln'><a href='#n251'>251</a></p>
 <p id='n252' class='pln'><a href='#n252'>252</a></p>
-<p id='n253' class='pln'><a href='#n253'>253</a></p>
+<p id='n253' class='stm run hide_run'><a href='#n253'>253</a></p>
 <p id='n254' class='pln'><a href='#n254'>254</a></p>
 <p id='n255' class='pln'><a href='#n255'>255</a></p>
-<p id='n256' class='pln'><a href='#n256'>256</a></p>
+<p id='n256' class='stm run hide_run'><a href='#n256'>256</a></p>
 <p id='n257' class='pln'><a href='#n257'>257</a></p>
 <p id='n258' class='pln'><a href='#n258'>258</a></p>
 <p id='n259' class='pln'><a href='#n259'>259</a></p>
 <p id='n260' class='pln'><a href='#n260'>260</a></p>
-<p id='n261' class='stm mis'><a href='#n261'>261</a></p>
+<p id='n261' class='pln'><a href='#n261'>261</a></p>
 <p id='n262' class='pln'><a href='#n262'>262</a></p>
 <p id='n263' class='pln'><a href='#n263'>263</a></p>
 <p id='n264' class='pln'><a href='#n264'>264</a></p>
@@ -331,48 +331,48 @@ <h2 class='stats'>
 <p id='n268' class='pln'><a href='#n268'>268</a></p>
 <p id='n269' class='pln'><a href='#n269'>269</a></p>
 <p id='n270' class='pln'><a href='#n270'>270</a></p>
-<p id='n271' class='stm mis'><a href='#n271'>271</a></p>
+<p id='n271' class='pln'><a href='#n271'>271</a></p>
 <p id='n272' class='pln'><a href='#n272'>272</a></p>
 <p id='n273' class='pln'><a href='#n273'>273</a></p>
-<p id='n274' class='stm run hide_run'><a href='#n274'>274</a></p>
+<p id='n274' class='pln'><a href='#n274'>274</a></p>
 <p id='n275' class='pln'><a href='#n275'>275</a></p>
 <p id='n276' class='pln'><a href='#n276'>276</a></p>
 <p id='n277' class='pln'><a href='#n277'>277</a></p>
-<p id='n278' class='pln'><a href='#n278'>278</a></p>
-<p id='n279' class='pln'><a href='#n279'>279</a></p>
+<p id='n278' class='stm mis'><a href='#n278'>278</a></p>
+<p id='n279' class='stm mis'><a href='#n279'>279</a></p>
 <p id='n280' class='pln'><a href='#n280'>280</a></p>
-<p id='n281' class='pln'><a href='#n281'>281</a></p>
-<p id='n282' class='pln'><a href='#n282'>282</a></p>
-<p id='n283' class='pln'><a href='#n283'>283</a></p>
-<p id='n284' class='pln'><a href='#n284'>284</a></p>
-<p id='n285' class='pln'><a href='#n285'>285</a></p>
-<p id='n286' class='pln'><a href='#n286'>286</a></p>
-<p id='n287' class='pln'><a href='#n287'>287</a></p>
-<p id='n288' class='pln'><a href='#n288'>288</a></p>
-<p id='n289' class='pln'><a href='#n289'>289</a></p>
+<p id='n281' class='stm mis'><a href='#n281'>281</a></p>
+<p id='n282' class='stm mis'><a href='#n282'>282</a></p>
+<p id='n283' class='stm mis'><a href='#n283'>283</a></p>
+<p id='n284' class='stm mis'><a href='#n284'>284</a></p>
+<p id='n285' class='stm mis'><a href='#n285'>285</a></p>
+<p id='n286' class='stm mis'><a href='#n286'>286</a></p>
+<p id='n287' class='stm mis'><a href='#n287'>287</a></p>
+<p id='n288' class='stm mis'><a href='#n288'>288</a></p>
+<p id='n289' class='stm mis'><a href='#n289'>289</a></p>
 <p id='n290' class='pln'><a href='#n290'>290</a></p>
 <p id='n291' class='pln'><a href='#n291'>291</a></p>
 <p id='n292' class='pln'><a href='#n292'>292</a></p>
-<p id='n293' class='pln'><a href='#n293'>293</a></p>
-<p id='n294' class='pln'><a href='#n294'>294</a></p>
+<p id='n293' class='stm run hide_run'><a href='#n293'>293</a></p>
+<p id='n294' class='stm run hide_run'><a href='#n294'>294</a></p>
 <p id='n295' class='pln'><a href='#n295'>295</a></p>
-<p id='n296' class='stm mis'><a href='#n296'>296</a></p>
-<p id='n297' class='stm mis'><a href='#n297'>297</a></p>
+<p id='n296' class='pln'><a href='#n296'>296</a></p>
+<p id='n297' class='pln'><a href='#n297'>297</a></p>
 <p id='n298' class='pln'><a href='#n298'>298</a></p>
-<p id='n299' class='stm mis'><a href='#n299'>299</a></p>
-<p id='n300' class='stm mis'><a href='#n300'>300</a></p>
-<p id='n301' class='stm mis'><a href='#n301'>301</a></p>
-<p id='n302' class='stm mis'><a href='#n302'>302</a></p>
-<p id='n303' class='stm mis'><a href='#n303'>303</a></p>
-<p id='n304' class='stm mis'><a href='#n304'>304</a></p>
-<p id='n305' class='stm mis'><a href='#n305'>305</a></p>
-<p id='n306' class='stm mis'><a href='#n306'>306</a></p>
-<p id='n307' class='stm mis'><a href='#n307'>307</a></p>
+<p id='n299' class='pln'><a href='#n299'>299</a></p>
+<p id='n300' class='pln'><a href='#n300'>300</a></p>
+<p id='n301' class='pln'><a href='#n301'>301</a></p>
+<p id='n302' class='pln'><a href='#n302'>302</a></p>
+<p id='n303' class='pln'><a href='#n303'>303</a></p>
+<p id='n304' class='pln'><a href='#n304'>304</a></p>
+<p id='n305' class='pln'><a href='#n305'>305</a></p>
+<p id='n306' class='pln'><a href='#n306'>306</a></p>
+<p id='n307' class='pln'><a href='#n307'>307</a></p>
 <p id='n308' class='pln'><a href='#n308'>308</a></p>
 <p id='n309' class='pln'><a href='#n309'>309</a></p>
 <p id='n310' class='pln'><a href='#n310'>310</a></p>
-<p id='n311' class='stm run hide_run'><a href='#n311'>311</a></p>
-<p id='n312' class='stm run hide_run'><a href='#n312'>312</a></p>
+<p id='n311' class='pln'><a href='#n311'>311</a></p>
+<p id='n312' class='pln'><a href='#n312'>312</a></p>
 <p id='n313' class='pln'><a href='#n313'>313</a></p>
 <p id='n314' class='pln'><a href='#n314'>314</a></p>
 <p id='n315' class='pln'><a href='#n315'>315</a></p>
@@ -402,36 +402,36 @@ <h2 class='stats'>
 <p id='n339' class='pln'><a href='#n339'>339</a></p>
 <p id='n340' class='pln'><a href='#n340'>340</a></p>
 <p id='n341' class='pln'><a href='#n341'>341</a></p>
-<p id='n342' class='pln'><a href='#n342'>342</a></p>
-<p id='n343' class='pln'><a href='#n343'>343</a></p>
-<p id='n344' class='pln'><a href='#n344'>344</a></p>
-<p id='n345' class='pln'><a href='#n345'>345</a></p>
-<p id='n346' class='pln'><a href='#n346'>346</a></p>
-<p id='n347' class='pln'><a href='#n347'>347</a></p>
-<p id='n348' class='pln'><a href='#n348'>348</a></p>
-<p id='n349' class='pln'><a href='#n349'>349</a></p>
-<p id='n350' class='pln'><a href='#n350'>350</a></p>
-<p id='n351' class='pln'><a href='#n351'>351</a></p>
+<p id='n342' class='stm run hide_run'><a href='#n342'>342</a></p>
+<p id='n343' class='stm run hide_run'><a href='#n343'>343</a></p>
+<p id='n344' class='stm run hide_run'><a href='#n344'>344</a></p>
+<p id='n345' class='stm run hide_run'><a href='#n345'>345</a></p>
+<p id='n346' class='stm run hide_run'><a href='#n346'>346</a></p>
+<p id='n347' class='stm run hide_run'><a href='#n347'>347</a></p>
+<p id='n348' class='stm mis'><a href='#n348'>348</a></p>
+<p id='n349' class='stm run hide_run'><a href='#n349'>349</a></p>
+<p id='n350' class='stm mis'><a href='#n350'>350</a></p>
+<p id='n351' class='stm run hide_run'><a href='#n351'>351</a></p>
 <p id='n352' class='pln'><a href='#n352'>352</a></p>
-<p id='n353' class='pln'><a href='#n353'>353</a></p>
+<p id='n353' class='stm mis'><a href='#n353'>353</a></p>
 <p id='n354' class='pln'><a href='#n354'>354</a></p>
 <p id='n355' class='pln'><a href='#n355'>355</a></p>
 <p id='n356' class='pln'><a href='#n356'>356</a></p>
 <p id='n357' class='pln'><a href='#n357'>357</a></p>
 <p id='n358' class='pln'><a href='#n358'>358</a></p>
 <p id='n359' class='pln'><a href='#n359'>359</a></p>
-<p id='n360' class='stm run hide_run'><a href='#n360'>360</a></p>
-<p id='n361' class='stm run hide_run'><a href='#n361'>361</a></p>
-<p id='n362' class='stm run hide_run'><a href='#n362'>362</a></p>
+<p id='n360' class='pln'><a href='#n360'>360</a></p>
+<p id='n361' class='pln'><a href='#n361'>361</a></p>
+<p id='n362' class='pln'><a href='#n362'>362</a></p>
 <p id='n363' class='stm run hide_run'><a href='#n363'>363</a></p>
-<p id='n364' class='stm run hide_run'><a href='#n364'>364</a></p>
-<p id='n365' class='stm run hide_run'><a href='#n365'>365</a></p>
-<p id='n366' class='stm mis'><a href='#n366'>366</a></p>
-<p id='n367' class='stm run hide_run'><a href='#n367'>367</a></p>
-<p id='n368' class='stm mis'><a href='#n368'>368</a></p>
-<p id='n369' class='stm run hide_run'><a href='#n369'>369</a></p>
+<p id='n364' class='pln'><a href='#n364'>364</a></p>
+<p id='n365' class='pln'><a href='#n365'>365</a></p>
+<p id='n366' class='pln'><a href='#n366'>366</a></p>
+<p id='n367' class='pln'><a href='#n367'>367</a></p>
+<p id='n368' class='pln'><a href='#n368'>368</a></p>
+<p id='n369' class='pln'><a href='#n369'>369</a></p>
 <p id='n370' class='pln'><a href='#n370'>370</a></p>
-<p id='n371' class='stm mis'><a href='#n371'>371</a></p>
+<p id='n371' class='pln'><a href='#n371'>371</a></p>
 <p id='n372' class='pln'><a href='#n372'>372</a></p>
 <p id='n373' class='pln'><a href='#n373'>373</a></p>
 <p id='n374' class='pln'><a href='#n374'>374</a></p>
@@ -441,7 +441,7 @@ <h2 class='stats'>
 <p id='n378' class='pln'><a href='#n378'>378</a></p>
 <p id='n379' class='pln'><a href='#n379'>379</a></p>
 <p id='n380' class='pln'><a href='#n380'>380</a></p>
-<p id='n381' class='stm run hide_run'><a href='#n381'>381</a></p>
+<p id='n381' class='pln'><a href='#n381'>381</a></p>
 <p id='n382' class='pln'><a href='#n382'>382</a></p>
 <p id='n383' class='pln'><a href='#n383'>383</a></p>
 <p id='n384' class='pln'><a href='#n384'>384</a></p>
@@ -456,86 +456,86 @@ <h2 class='stats'>
 <p id='n393' class='pln'><a href='#n393'>393</a></p>
 <p id='n394' class='pln'><a href='#n394'>394</a></p>
 <p id='n395' class='pln'><a href='#n395'>395</a></p>
-<p id='n396' class='pln'><a href='#n396'>396</a></p>
-<p id='n397' class='pln'><a href='#n397'>397</a></p>
-<p id='n398' class='pln'><a href='#n398'>398</a></p>
-<p id='n399' class='pln'><a href='#n399'>399</a></p>
-<p id='n400' class='pln'><a href='#n400'>400</a></p>
-<p id='n401' class='pln'><a href='#n401'>401</a></p>
-<p id='n402' class='pln'><a href='#n402'>402</a></p>
-<p id='n403' class='pln'><a href='#n403'>403</a></p>
-<p id='n404' class='pln'><a href='#n404'>404</a></p>
-<p id='n405' class='pln'><a href='#n405'>405</a></p>
+<p id='n396' class='stm run hide_run'><a href='#n396'>396</a></p>
+<p id='n397' class='stm run hide_run'><a href='#n397'>397</a></p>
+<p id='n398' class='stm run hide_run'><a href='#n398'>398</a></p>
+<p id='n399' class='stm run hide_run'><a href='#n399'>399</a></p>
+<p id='n400' class='stm run hide_run'><a href='#n400'>400</a></p>
+<p id='n401' class='stm run hide_run'><a href='#n401'>401</a></p>
+<p id='n402' class='stm run hide_run'><a href='#n402'>402</a></p>
+<p id='n403' class='stm run hide_run'><a href='#n403'>403</a></p>
+<p id='n404' class='stm run hide_run'><a href='#n404'>404</a></p>
+<p id='n405' class='stm run hide_run'><a href='#n405'>405</a></p>
 <p id='n406' class='pln'><a href='#n406'>406</a></p>
-<p id='n407' class='pln'><a href='#n407'>407</a></p>
-<p id='n408' class='pln'><a href='#n408'>408</a></p>
-<p id='n409' class='pln'><a href='#n409'>409</a></p>
-<p id='n410' class='pln'><a href='#n410'>410</a></p>
+<p id='n407' class='stm run hide_run'><a href='#n407'>407</a></p>
+<p id='n408' class='stm run hide_run'><a href='#n408'>408</a></p>
+<p id='n409' class='stm run hide_run'><a href='#n409'>409</a></p>
+<p id='n410' class='stm run hide_run'><a href='#n410'>410</a></p>
 <p id='n411' class='pln'><a href='#n411'>411</a></p>
-<p id='n412' class='pln'><a href='#n412'>412</a></p>
-<p id='n413' class='pln'><a href='#n413'>413</a></p>
-<p id='n414' class='stm mis'><a href='#n414'>414</a></p>
-<p id='n415' class='stm mis'><a href='#n415'>415</a></p>
-<p id='n416' class='stm mis'><a href='#n416'>416</a></p>
-<p id='n417' class='stm mis'><a href='#n417'>417</a></p>
+<p id='n412' class='stm run hide_run'><a href='#n412'>412</a></p>
+<p id='n413' class='stm run hide_run'><a href='#n413'>413</a></p>
+<p id='n414' class='stm run hide_run'><a href='#n414'>414</a></p>
+<p id='n415' class='stm run hide_run'><a href='#n415'>415</a></p>
+<p id='n416' class='stm run hide_run'><a href='#n416'>416</a></p>
+<p id='n417' class='stm run hide_run'><a href='#n417'>417</a></p>
 <p id='n418' class='stm mis'><a href='#n418'>418</a></p>
 <p id='n419' class='stm mis'><a href='#n419'>419</a></p>
 <p id='n420' class='stm mis'><a href='#n420'>420</a></p>
 <p id='n421' class='stm mis'><a href='#n421'>421</a></p>
 <p id='n422' class='stm mis'><a href='#n422'>422</a></p>
 <p id='n423' class='stm mis'><a href='#n423'>423</a></p>
-<p id='n424' class='pln'><a href='#n424'>424</a></p>
+<p id='n424' class='stm mis'><a href='#n424'>424</a></p>
 <p id='n425' class='stm mis'><a href='#n425'>425</a></p>
 <p id='n426' class='stm mis'><a href='#n426'>426</a></p>
 <p id='n427' class='stm mis'><a href='#n427'>427</a></p>
-<p id='n428' class='stm mis'><a href='#n428'>428</a></p>
+<p id='n428' class='stm run hide_run'><a href='#n428'>428</a></p>
 <p id='n429' class='pln'><a href='#n429'>429</a></p>
-<p id='n430' class='stm mis'><a href='#n430'>430</a></p>
-<p id='n431' class='stm mis'><a href='#n431'>431</a></p>
-<p id='n432' class='stm mis'><a href='#n432'>432</a></p>
-<p id='n433' class='stm mis'><a href='#n433'>433</a></p>
-<p id='n434' class='stm mis'><a href='#n434'>434</a></p>
-<p id='n435' class='stm mis'><a href='#n435'>435</a></p>
-<p id='n436' class='stm mis'><a href='#n436'>436</a></p>
-<p id='n437' class='stm mis'><a href='#n437'>437</a></p>
-<p id='n438' class='stm mis'><a href='#n438'>438</a></p>
-<p id='n439' class='stm mis'><a href='#n439'>439</a></p>
-<p id='n440' class='stm mis'><a href='#n440'>440</a></p>
-<p id='n441' class='stm mis'><a href='#n441'>441</a></p>
+<p id='n430' class='pln'><a href='#n430'>430</a></p>
+<p id='n431' class='stm run hide_run'><a href='#n431'>431</a></p>
+<p id='n432' class='pln'><a href='#n432'>432</a></p>
+<p id='n433' class='pln'><a href='#n433'>433</a></p>
+<p id='n434' class='pln'><a href='#n434'>434</a></p>
+<p id='n435' class='pln'><a href='#n435'>435</a></p>
+<p id='n436' class='pln'><a href='#n436'>436</a></p>
+<p id='n437' class='stm run hide_run'><a href='#n437'>437</a></p>
+<p id='n438' class='stm run hide_run'><a href='#n438'>438</a></p>
+<p id='n439' class='stm run hide_run'><a href='#n439'>439</a></p>
+<p id='n440' class='stm run hide_run'><a href='#n440'>440</a></p>
+<p id='n441' class='stm run hide_run'><a href='#n441'>441</a></p>
 <p id='n442' class='stm mis'><a href='#n442'>442</a></p>
 <p id='n443' class='stm mis'><a href='#n443'>443</a></p>
-<p id='n444' class='stm mis'><a href='#n444'>444</a></p>
-<p id='n445' class='stm mis'><a href='#n445'>445</a></p>
-<p id='n446' class='stm mis'><a href='#n446'>446</a></p>
-<p id='n447' class='pln'><a href='#n447'>447</a></p>
+<p id='n444' class='pln'><a href='#n444'>444</a></p>
+<p id='n445' class='pln'><a href='#n445'>445</a></p>
+<p id='n446' class='stm run hide_run'><a href='#n446'>446</a></p>
+<p id='n447' class='stm mis'><a href='#n447'>447</a></p>
 <p id='n448' class='pln'><a href='#n448'>448</a></p>
 <p id='n449' class='stm run hide_run'><a href='#n449'>449</a></p>
-<p id='n450' class='pln'><a href='#n450'>450</a></p>
-<p id='n451' class='pln'><a href='#n451'>451</a></p>
-<p id='n452' class='pln'><a href='#n452'>452</a></p>
+<p id='n450' class='stm run hide_run'><a href='#n450'>450</a></p>
+<p id='n451' class='stm run hide_run'><a href='#n451'>451</a></p>
+<p id='n452' class='stm run hide_run'><a href='#n452'>452</a></p>
 <p id='n453' class='pln'><a href='#n453'>453</a></p>
 <p id='n454' class='pln'><a href='#n454'>454</a></p>
 <p id='n455' class='stm run hide_run'><a href='#n455'>455</a></p>
-<p id='n456' class='stm run hide_run'><a href='#n456'>456</a></p>
-<p id='n457' class='stm run hide_run'><a href='#n457'>457</a></p>
-<p id='n458' class='stm run hide_run'><a href='#n458'>458</a></p>
-<p id='n459' class='stm run hide_run'><a href='#n459'>459</a></p>
-<p id='n460' class='stm mis'><a href='#n460'>460</a></p>
-<p id='n461' class='stm mis'><a href='#n461'>461</a></p>
+<p id='n456' class='pln'><a href='#n456'>456</a></p>
+<p id='n457' class='pln'><a href='#n457'>457</a></p>
+<p id='n458' class='pln'><a href='#n458'>458</a></p>
+<p id='n459' class='pln'><a href='#n459'>459</a></p>
+<p id='n460' class='pln'><a href='#n460'>460</a></p>
+<p id='n461' class='pln'><a href='#n461'>461</a></p>
 <p id='n462' class='pln'><a href='#n462'>462</a></p>
-<p id='n463' class='pln'><a href='#n463'>463</a></p>
+<p id='n463' class='stm run hide_run'><a href='#n463'>463</a></p>
 <p id='n464' class='stm run hide_run'><a href='#n464'>464</a></p>
-<p id='n465' class='stm mis'><a href='#n465'>465</a></p>
-<p id='n466' class='pln'><a href='#n466'>466</a></p>
+<p id='n465' class='stm run hide_run'><a href='#n465'>465</a></p>
+<p id='n466' class='stm run hide_run'><a href='#n466'>466</a></p>
 <p id='n467' class='stm run hide_run'><a href='#n467'>467</a></p>
 <p id='n468' class='stm run hide_run'><a href='#n468'>468</a></p>
 <p id='n469' class='stm run hide_run'><a href='#n469'>469</a></p>
-<p id='n470' class='stm run hide_run'><a href='#n470'>470</a></p>
+<p id='n470' class='stm mis'><a href='#n470'>470</a></p>
 <p id='n471' class='pln'><a href='#n471'>471</a></p>
 <p id='n472' class='pln'><a href='#n472'>472</a></p>
-<p id='n473' class='stm run hide_run'><a href='#n473'>473</a></p>
+<p id='n473' class='pln'><a href='#n473'>473</a></p>
 <p id='n474' class='pln'><a href='#n474'>474</a></p>
-<p id='n475' class='pln'><a href='#n475'>475</a></p>
+<p id='n475' class='stm run hide_run'><a href='#n475'>475</a></p>
 <p id='n476' class='pln'><a href='#n476'>476</a></p>
 <p id='n477' class='pln'><a href='#n477'>477</a></p>
 <p id='n478' class='pln'><a href='#n478'>478</a></p>
@@ -543,74 +543,56 @@ <h2 class='stats'>
 <p id='n480' class='pln'><a href='#n480'>480</a></p>
 <p id='n481' class='stm run hide_run'><a href='#n481'>481</a></p>
 <p id='n482' class='stm run hide_run'><a href='#n482'>482</a></p>
-<p id='n483' class='stm run hide_run'><a href='#n483'>483</a></p>
-<p id='n484' class='stm run hide_run'><a href='#n484'>484</a></p>
+<p id='n483' class='stm mis'><a href='#n483'>483</a></p>
+<p id='n484' class='stm mis'><a href='#n484'>484</a></p>
 <p id='n485' class='stm run hide_run'><a href='#n485'>485</a></p>
 <p id='n486' class='stm run hide_run'><a href='#n486'>486</a></p>
-<p id='n487' class='stm mis'><a href='#n487'>487</a></p>
-<p id='n488' class='stm mis'><a href='#n488'>488</a></p>
-<p id='n489' class='pln'><a href='#n489'>489</a></p>
-<p id='n490' class='pln'><a href='#n490'>490</a></p>
-<p id='n491' class='pln'><a href='#n491'>491</a></p>
+<p id='n487' class='stm run hide_run'><a href='#n487'>487</a></p>
+<p id='n488' class='stm run hide_run'><a href='#n488'>488</a></p>
+<p id='n489' class='stm run hide_run'><a href='#n489'>489</a></p>
+<p id='n490' class='stm run hide_run'><a href='#n490'>490</a></p>
+<p id='n491' class='stm mis'><a href='#n491'>491</a></p>
 <p id='n492' class='pln'><a href='#n492'>492</a></p>
-<p id='n493' class='stm run hide_run'><a href='#n493'>493</a></p>
+<p id='n493' class='pln'><a href='#n493'>493</a></p>
 <p id='n494' class='pln'><a href='#n494'>494</a></p>
 <p id='n495' class='pln'><a href='#n495'>495</a></p>
 <p id='n496' class='pln'><a href='#n496'>496</a></p>
-<p id='n497' class='pln'><a href='#n497'>497</a></p>
+<p id='n497' class='stm run hide_run'><a href='#n497'>497</a></p>
 <p id='n498' class='pln'><a href='#n498'>498</a></p>
-<p id='n499' class='stm mis'><a href='#n499'>499</a></p>
-<p id='n500' class='stm mis'><a href='#n500'>500</a></p>
-<p id='n501' class='stm mis'><a href='#n501'>501</a></p>
-<p id='n502' class='stm mis'><a href='#n502'>502</a></p>
-<p id='n503' class='stm mis'><a href='#n503'>503</a></p>
+<p id='n499' class='pln'><a href='#n499'>499</a></p>
+<p id='n500' class='pln'><a href='#n500'>500</a></p>
+<p id='n501' class='pln'><a href='#n501'>501</a></p>
+<p id='n502' class='stm run hide_run'><a href='#n502'>502</a></p>
+<p id='n503' class='stm run hide_run'><a href='#n503'>503</a></p>
 <p id='n504' class='stm mis'><a href='#n504'>504</a></p>
-<p id='n505' class='stm mis'><a href='#n505'>505</a></p>
-<p id='n506' class='stm mis'><a href='#n506'>506</a></p>
-<p id='n507' class='stm mis'><a href='#n507'>507</a></p>
-<p id='n508' class='stm mis'><a href='#n508'>508</a></p>
-<p id='n509' class='stm mis'><a href='#n509'>509</a></p>
+<p id='n505' class='stm run hide_run'><a href='#n505'>505</a></p>
+<p id='n506' class='stm run hide_run'><a href='#n506'>506</a></p>
+<p id='n507' class='pln'><a href='#n507'>507</a></p>
+<p id='n508' class='pln'><a href='#n508'>508</a></p>
+<p id='n509' class='stm run hide_run'><a href='#n509'>509</a></p>
 <p id='n510' class='pln'><a href='#n510'>510</a></p>
-<p id='n511' class='pln'><a href='#n511'>511</a></p>
-<p id='n512' class='pln'><a href='#n512'>512</a></p>
-<p id='n513' class='pln'><a href='#n513'>513</a></p>
-<p id='n514' class='pln'><a href='#n514'>514</a></p>
-<p id='n515' class='stm mis'><a href='#n515'>515</a></p>
-<p id='n516' class='pln'><a href='#n516'>516</a></p>
-<p id='n517' class='pln'><a href='#n517'>517</a></p>
-<p id='n518' class='pln'><a href='#n518'>518</a></p>
-<p id='n519' class='pln'><a href='#n519'>519</a></p>
-<p id='n520' class='stm mis'><a href='#n520'>520</a></p>
-<p id='n521' class='stm mis'><a href='#n521'>521</a></p>
-<p id='n522' class='stm mis'><a href='#n522'>522</a></p>
-<p id='n523' class='stm mis'><a href='#n523'>523</a></p>
+<p id='n511' class='stm run hide_run'><a href='#n511'>511</a></p>
+<p id='n512' class='stm run hide_run'><a href='#n512'>512</a></p>
+<p id='n513' class='stm run hide_run'><a href='#n513'>513</a></p>
+<p id='n514' class='stm run hide_run'><a href='#n514'>514</a></p>
+<p id='n515' class='stm run hide_run'><a href='#n515'>515</a></p>
+<p id='n516' class='stm run hide_run'><a href='#n516'>516</a></p>
+<p id='n517' class='stm run hide_run'><a href='#n517'>517</a></p>
+<p id='n518' class='stm run hide_run'><a href='#n518'>518</a></p>
+<p id='n519' class='stm run hide_run'><a href='#n519'>519</a></p>
+<p id='n520' class='stm run hide_run'><a href='#n520'>520</a></p>
+<p id='n521' class='stm run hide_run'><a href='#n521'>521</a></p>
+<p id='n522' class='stm run hide_run'><a href='#n522'>522</a></p>
+<p id='n523' class='stm run hide_run'><a href='#n523'>523</a></p>
 <p id='n524' class='stm mis'><a href='#n524'>524</a></p>
 <p id='n525' class='pln'><a href='#n525'>525</a></p>
 <p id='n526' class='pln'><a href='#n526'>526</a></p>
-<p id='n527' class='stm run hide_run'><a href='#n527'>527</a></p>
+<p id='n527' class='pln'><a href='#n527'>527</a></p>
 <p id='n528' class='pln'><a href='#n528'>528</a></p>
-<p id='n529' class='stm run hide_run'><a href='#n529'>529</a></p>
+<p id='n529' class='pln'><a href='#n529'>529</a></p>
 <p id='n530' class='stm run hide_run'><a href='#n530'>530</a></p>
-<p id='n531' class='stm run hide_run'><a href='#n531'>531</a></p>
+<p id='n531' class='pln'><a href='#n531'>531</a></p>
 <p id='n532' class='stm run hide_run'><a href='#n532'>532</a></p>
-<p id='n533' class='stm run hide_run'><a href='#n533'>533</a></p>
-<p id='n534' class='stm run hide_run'><a href='#n534'>534</a></p>
-<p id='n535' class='stm run hide_run'><a href='#n535'>535</a></p>
-<p id='n536' class='stm run hide_run'><a href='#n536'>536</a></p>
-<p id='n537' class='stm run hide_run'><a href='#n537'>537</a></p>
-<p id='n538' class='stm run hide_run'><a href='#n538'>538</a></p>
-<p id='n539' class='stm run hide_run'><a href='#n539'>539</a></p>
-<p id='n540' class='stm run hide_run'><a href='#n540'>540</a></p>
-<p id='n541' class='stm run hide_run'><a href='#n541'>541</a></p>
-<p id='n542' class='stm mis'><a href='#n542'>542</a></p>
-<p id='n543' class='pln'><a href='#n543'>543</a></p>
-<p id='n544' class='pln'><a href='#n544'>544</a></p>
-<p id='n545' class='pln'><a href='#n545'>545</a></p>
-<p id='n546' class='pln'><a href='#n546'>546</a></p>
-<p id='n547' class='pln'><a href='#n547'>547</a></p>
-<p id='n548' class='stm run hide_run'><a href='#n548'>548</a></p>
-<p id='n549' class='pln'><a href='#n549'>549</a></p>
-<p id='n550' class='stm run hide_run'><a href='#n550'>550</a></p>
                 
             </td>
             <td class='text' valign='top'>
@@ -623,547 +605,529 @@ <h2 class='stats'>
 <p id='t7' class='pln'><span class='str'>Functions that USERS will possibly want access to.</span><span class='strut'>&nbsp;</span></p>
 <p id='t8' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t9' class='pln'><span class='str'>&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t10' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>os</span><span class='strut'>&nbsp;</span></p>
-<p id='t11' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='strut'>&nbsp;</span></p>
-<p id='t12' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>warnings</span><span class='strut'>&nbsp;</span></p>
-<p id='t13' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t14' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span> <span class='key'>import</span> <span class='nam'>utils</span><span class='strut'>&nbsp;</span></p>
-<p id='t15' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span> <span class='key'>import</span> <span class='nam'>exceptions</span><span class='strut'>&nbsp;</span></p>
+<p id='t10' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>__future__</span> <span class='key'>import</span> <span class='nam'>absolute_import</span><span class='strut'>&nbsp;</span></p>
+<p id='t11' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t12' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>os</span><span class='strut'>&nbsp;</span></p>
+<p id='t13' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='strut'>&nbsp;</span></p>
+<p id='t14' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>warnings</span><span class='strut'>&nbsp;</span></p>
+<p id='t15' class='stm run hide_run'><span class='key'>import</span> <span class='nam'>six</span><span class='strut'>&nbsp;</span></p>
 <p id='t16' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t17' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t18' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t17' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>plotly</span> <span class='key'>import</span> <span class='nam'>utils</span><span class='strut'>&nbsp;</span></p>
+<p id='t18' class='stm run hide_run'><span class='key'>from</span> <span class='nam'>plotly</span> <span class='key'>import</span> <span class='nam'>exceptions</span><span class='strut'>&nbsp;</span></p>
 <p id='t19' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t20' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t21' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t22' class='pln'><span class='com'># Warning format</span><span class='strut'>&nbsp;</span></p>
-<p id='t23' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span> <span class='key'>import</span> <span class='nam'>matplotlylib</span><span class='strut'>&nbsp;</span></p>
-<p id='t24' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span> <span class='nam'>graph_objs</span> <span class='key'>import</span> <span class='nam'>graph_objs</span><span class='strut'>&nbsp;</span></p>
-<p id='t25' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t26' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>warning_on_one_line</span><span class='op'>(</span><span class='nam'>message</span><span class='op'>,</span> <span class='nam'>category</span><span class='op'>,</span> <span class='nam'>filename</span><span class='op'>,</span> <span class='nam'>lineno</span><span class='op'>,</span> <span class='nam'>file</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>line</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t27' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='str'>&#39;%s:%s: %s:\n\n%s\n\n&#39;</span> <span class='op'>%</span> <span class='op'>(</span><span class='nam'>filename</span><span class='op'>,</span> <span class='nam'>lineno</span><span class='op'>,</span> <span class='nam'>category</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>,</span> <span class='nam'>message</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t28' class='stm run hide_run'><span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>formatwarning</span> <span class='op'>=</span> <span class='nam'>warning_on_one_line</span><span class='strut'>&nbsp;</span></p>
-<p id='t29' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t30' class='stm run hide_run'><span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t31' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>_matplotlylib_imported</span> <span class='op'>=</span> <span class='nam'>True</span><span class='strut'>&nbsp;</span></p>
-<p id='t32' class='stm mis'><span class='key'>except</span> <span class='nam'>ImportError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t33' class='stm mis'>&nbsp; &nbsp; <span class='nam'>_matplotlylib_imported</span> <span class='op'>=</span> <span class='nam'>False</span><span class='strut'>&nbsp;</span></p>
-<p id='t34' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t35' class='stm run hide_run'><span class='nam'>PLOTLY_DIR</span> <span class='op'>=</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>expanduser</span><span class='op'>(</span><span class='str'>&quot;~&quot;</span><span class='op'>)</span><span class='op'>,</span> <span class='str'>&quot;.plotly&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t36' class='stm run hide_run'><span class='nam'>CREDENTIALS_FILE</span> <span class='op'>=</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>,</span> <span class='str'>&quot;.credentials&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t37' class='stm run hide_run'><span class='nam'>CONFIG_FILE</span> <span class='op'>=</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>,</span> <span class='str'>&quot;.config&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t38' class='stm run hide_run'><span class='nam'>TEST_DIR</span> <span class='op'>=</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>expanduser</span><span class='op'>(</span><span class='str'>&quot;~&quot;</span><span class='op'>)</span><span class='op'>,</span> <span class='str'>&quot;.test&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t39' class='stm run hide_run'><span class='nam'>TEST_FILE</span> <span class='op'>=</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>,</span> <span class='str'>&quot;.permission_test&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t40' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t41' class='pln'><span class='com'># this sets both the DEFAULTS and the TYPES for these items</span><span class='strut'>&nbsp;</span></p>
-<p id='t42' class='stm run hide_run'><span class='nam'>_FILE_CONTENT</span> <span class='op'>=</span> <span class='op'>{</span><span class='nam'>CREDENTIALS_FILE</span><span class='op'>:</span> <span class='op'>{</span><span class='str'>&#39;username&#39;</span><span class='op'>:</span> <span class='str'>&#39;&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t43' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;api_key&#39;</span><span class='op'>:</span> <span class='str'>&#39;&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t44' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;stream_ids&#39;</span><span class='op'>:</span> <span class='op'>[</span><span class='op'>]</span><span class='op'>}</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t45' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>CONFIG_FILE</span><span class='op'>:</span> <span class='op'>{</span><span class='str'>&#39;plotly_domain&#39;</span><span class='op'>:</span> <span class='str'>&#39;https://plot.ly&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t46' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly_streaming_domain&#39;</span><span class='op'>:</span> <span class='str'>&#39;stream.plot.ly&#39;</span><span class='op'>}</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
-<p id='t47' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t48' class='stm run hide_run'><span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t49' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>os</span><span class='op'>.</span><span class='nam'>mkdir</span><span class='op'>(</span><span class='nam'>TEST_DIR</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t50' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>os</span><span class='op'>.</span><span class='nam'>rmdir</span><span class='op'>(</span><span class='nam'>TEST_DIR</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t51' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>exists</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t52' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>os</span><span class='op'>.</span><span class='nam'>mkdir</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t53' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>f</span> <span class='op'>=</span> <span class='nam'>open</span><span class='op'>(</span><span class='nam'>TEST_FILE</span><span class='op'>,</span> <span class='str'>&#39;w&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t54' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>f</span><span class='op'>.</span><span class='nam'>write</span><span class='op'>(</span><span class='str'>&#39;testing\n&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t55' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>f</span><span class='op'>.</span><span class='nam'>close</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t56' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>os</span><span class='op'>.</span><span class='nam'>remove</span><span class='op'>(</span><span class='nam'>TEST_FILE</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t57' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>_file_permissions</span> <span class='op'>=</span> <span class='nam'>True</span><span class='strut'>&nbsp;</span></p>
-<p id='t58' class='stm mis'><span class='key'>except</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t59' class='stm mis'>&nbsp; &nbsp; <span class='nam'>_file_permissions</span> <span class='op'>=</span> <span class='nam'>False</span><span class='strut'>&nbsp;</span></p>
-<p id='t60' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t61' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t62' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>check_file_permissions</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t63' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>_file_permissions</span><span class='strut'>&nbsp;</span></p>
-<p id='t64' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t65' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t66' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t67' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Ensure that filesystem is setup/filled out in a valid way&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t68' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>_file_permissions</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t69' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>isdir</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t70' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>os</span><span class='op'>.</span><span class='nam'>mkdir</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t71' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>fn</span> <span class='key'>in</span> <span class='op'>[</span><span class='nam'>CREDENTIALS_FILE</span><span class='op'>,</span> <span class='nam'>CONFIG_FILE</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t72' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>contents</span> <span class='op'>=</span> <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>load_json_dict</span><span class='op'>(</span><span class='nam'>fn</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t73' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>_FILE_CONTENT</span><span class='op'>[</span><span class='nam'>fn</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t74' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># TODO: removed type checking below, may want to revisit</span><span class='strut'>&nbsp;</span></p>
-<p id='t75' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>contents</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t76' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>contents</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
-<p id='t77' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>contents_keys</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>contents</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t78' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>contents_keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t79' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>_FILE_CONTENT</span><span class='op'>[</span><span class='nam'>fn</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t80' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>contents</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t81' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>save_json_dict</span><span class='op'>(</span><span class='nam'>fn</span><span class='op'>,</span> <span class='nam'>contents</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t82' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t83' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;Looks like you don&#39;t have &#39;read-write&#39; permission to &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t84' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;your &#39;home&#39; (&#39;~&#39;) directory or to our &#39;~/.plotly&#39; &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t85' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;directory. That means plotly&#39;s python api can&#39;t setup &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t86' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;local configuration files. No problem though! You&#39;ll &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t87' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;just have to sign-in using &#39;plotly.sign_in()&#39;. For help &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t88' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;with that: &#39;help(plotly.sign_in)&#39;.&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t89' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;\nQuestions? support@plot.ly&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t90' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t20' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span> <span class='key'>import</span> <span class='nam'>matplotlylib</span><span class='strut'>&nbsp;</span></p>
+<p id='t21' class='stm run hide_run'><span class='key'>from</span> <span class='op'>.</span> <span class='nam'>graph_objs</span> <span class='key'>import</span> <span class='nam'>graph_objs</span><span class='strut'>&nbsp;</span></p>
+<p id='t22' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t23' class='pln'><span class='com'># Warning format</span><span class='strut'>&nbsp;</span></p>
+<p id='t24' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>warning_on_one_line</span><span class='op'>(</span><span class='nam'>message</span><span class='op'>,</span> <span class='nam'>category</span><span class='op'>,</span> <span class='nam'>filename</span><span class='op'>,</span> <span class='nam'>lineno</span><span class='op'>,</span> <span class='nam'>file</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>line</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t25' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='str'>&#39;%s:%s: %s:\n\n%s\n\n&#39;</span> <span class='op'>%</span> <span class='op'>(</span><span class='nam'>filename</span><span class='op'>,</span> <span class='nam'>lineno</span><span class='op'>,</span> <span class='nam'>category</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>,</span> <span class='nam'>message</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t26' class='stm run hide_run'><span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>formatwarning</span> <span class='op'>=</span> <span class='nam'>warning_on_one_line</span><span class='strut'>&nbsp;</span></p>
+<p id='t27' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t28' class='stm run hide_run'><span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t29' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>_matplotlylib_imported</span> <span class='op'>=</span> <span class='nam'>True</span><span class='strut'>&nbsp;</span></p>
+<p id='t30' class='stm mis'><span class='key'>except</span> <span class='nam'>ImportError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t31' class='stm mis'>&nbsp; &nbsp; <span class='nam'>_matplotlylib_imported</span> <span class='op'>=</span> <span class='nam'>False</span><span class='strut'>&nbsp;</span></p>
+<p id='t32' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t33' class='stm run hide_run'><span class='nam'>PLOTLY_DIR</span> <span class='op'>=</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>expanduser</span><span class='op'>(</span><span class='str'>&quot;~&quot;</span><span class='op'>)</span><span class='op'>,</span> <span class='str'>&quot;.plotly&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t34' class='stm run hide_run'><span class='nam'>CREDENTIALS_FILE</span> <span class='op'>=</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>,</span> <span class='str'>&quot;.credentials&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t35' class='stm run hide_run'><span class='nam'>CONFIG_FILE</span> <span class='op'>=</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>,</span> <span class='str'>&quot;.config&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t36' class='stm run hide_run'><span class='nam'>TEST_DIR</span> <span class='op'>=</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>expanduser</span><span class='op'>(</span><span class='str'>&quot;~&quot;</span><span class='op'>)</span><span class='op'>,</span> <span class='str'>&quot;.test&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t37' class='stm run hide_run'><span class='nam'>TEST_FILE</span> <span class='op'>=</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>join</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>,</span> <span class='str'>&quot;.permission_test&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t38' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t39' class='pln'><span class='com'># this sets both the DEFAULTS and the TYPES for these items</span><span class='strut'>&nbsp;</span></p>
+<p id='t40' class='stm run hide_run'><span class='nam'>_FILE_CONTENT</span> <span class='op'>=</span> <span class='op'>{</span><span class='nam'>CREDENTIALS_FILE</span><span class='op'>:</span> <span class='op'>{</span><span class='str'>&#39;username&#39;</span><span class='op'>:</span> <span class='str'>&#39;&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t41' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;api_key&#39;</span><span class='op'>:</span> <span class='str'>&#39;&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t42' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&#39;stream_ids&#39;</span><span class='op'>:</span> <span class='op'>[</span><span class='op'>]</span><span class='op'>}</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t43' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>CONFIG_FILE</span><span class='op'>:</span> <span class='op'>{</span><span class='str'>&#39;plotly_domain&#39;</span><span class='op'>:</span> <span class='str'>&#39;https://plot.ly&#39;</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t44' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&#39;plotly_streaming_domain&#39;</span><span class='op'>:</span> <span class='str'>&#39;stream.plot.ly&#39;</span><span class='op'>}</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
+<p id='t45' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t46' class='stm run hide_run'><span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t47' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>os</span><span class='op'>.</span><span class='nam'>mkdir</span><span class='op'>(</span><span class='nam'>TEST_DIR</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t48' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>os</span><span class='op'>.</span><span class='nam'>rmdir</span><span class='op'>(</span><span class='nam'>TEST_DIR</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t49' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>exists</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t50' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>os</span><span class='op'>.</span><span class='nam'>mkdir</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t51' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>f</span> <span class='op'>=</span> <span class='nam'>open</span><span class='op'>(</span><span class='nam'>TEST_FILE</span><span class='op'>,</span> <span class='str'>&#39;w&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t52' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>f</span><span class='op'>.</span><span class='nam'>write</span><span class='op'>(</span><span class='str'>&#39;testing\n&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t53' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>f</span><span class='op'>.</span><span class='nam'>close</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t54' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>os</span><span class='op'>.</span><span class='nam'>remove</span><span class='op'>(</span><span class='nam'>TEST_FILE</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t55' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>_file_permissions</span> <span class='op'>=</span> <span class='nam'>True</span><span class='strut'>&nbsp;</span></p>
+<p id='t56' class='stm mis'><span class='key'>except</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t57' class='stm mis'>&nbsp; &nbsp; <span class='nam'>_file_permissions</span> <span class='op'>=</span> <span class='nam'>False</span><span class='strut'>&nbsp;</span></p>
+<p id='t58' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t59' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t60' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>check_file_permissions</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t61' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>_file_permissions</span><span class='strut'>&nbsp;</span></p>
+<p id='t62' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t63' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t64' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t65' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Ensure that filesystem is setup/filled out in a valid way&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t66' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>_file_permissions</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t67' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>os</span><span class='op'>.</span><span class='nam'>path</span><span class='op'>.</span><span class='nam'>isdir</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t68' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>os</span><span class='op'>.</span><span class='nam'>mkdir</span><span class='op'>(</span><span class='nam'>PLOTLY_DIR</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t69' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>fn</span> <span class='key'>in</span> <span class='op'>[</span><span class='nam'>CREDENTIALS_FILE</span><span class='op'>,</span> <span class='nam'>CONFIG_FILE</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t70' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>contents</span> <span class='op'>=</span> <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>load_json_dict</span><span class='op'>(</span><span class='nam'>fn</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t71' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>_FILE_CONTENT</span><span class='op'>[</span><span class='nam'>fn</span><span class='op'>]</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t72' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># TODO: removed type checking below, may want to revisit</span><span class='strut'>&nbsp;</span></p>
+<p id='t73' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>contents</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t74' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>contents</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
+<p id='t75' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>contents_keys</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>contents</span><span class='op'>.</span><span class='nam'>keys</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t76' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>contents_keys</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t77' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='key'>not</span> <span class='key'>in</span> <span class='nam'>_FILE_CONTENT</span><span class='op'>[</span><span class='nam'>fn</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t78' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>del</span> <span class='nam'>contents</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t79' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>save_json_dict</span><span class='op'>(</span><span class='nam'>fn</span><span class='op'>,</span> <span class='nam'>contents</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t80' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t81' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;Looks like you don&#39;t have &#39;read-write&#39; permission to &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t82' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;your &#39;home&#39; (&#39;~&#39;) directory or to our &#39;~/.plotly&#39; &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t83' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;directory. That means plotly&#39;s python api can&#39;t setup &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t84' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;local configuration files. No problem though! You&#39;ll &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t85' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;just have to sign-in using &#39;plotly.sign_in()&#39;. For help &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t86' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;with that: &#39;help(plotly.sign_in)&#39;.&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t87' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;\nQuestions? support@plot.ly&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t88' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t89' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t90' class='pln'><span class='com'>### credentials tools ###</span><span class='strut'>&nbsp;</span></p>
 <p id='t91' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t92' class='pln'><span class='com'>### credentials tools ###</span><span class='strut'>&nbsp;</span></p>
-<p id='t93' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t94' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>set_credentials_file</span><span class='op'>(</span><span class='nam'>username</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>stream_ids</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t95' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Set the keyword-value pairs in `~/.plotly_credentials`.</span><span class='strut'>&nbsp;</span></p>
-<p id='t96' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t97' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t98' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>_file_permissions</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t99' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;You don&#39;t have proper file permissions &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t100' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;to run this function.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t101' class='stm mis'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
-<p id='t102' class='stm mis'>&nbsp; &nbsp; <span class='nam'>credentials</span> <span class='op'>=</span> <span class='nam'>get_credentials_file</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t103' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>str</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t104' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>credentials</span><span class='op'>[</span><span class='str'>&#39;username&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>username</span><span class='strut'>&nbsp;</span></p>
-<p id='t105' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>api_key</span><span class='op'>,</span> <span class='nam'>str</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t106' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>credentials</span><span class='op'>[</span><span class='str'>&#39;api_key&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>api_key</span><span class='strut'>&nbsp;</span></p>
-<p id='t107' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>stream_ids</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>list</span><span class='op'>,</span> <span class='nam'>tuple</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t108' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>credentials</span><span class='op'>[</span><span class='str'>&#39;stream_ids&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>stream_ids</span><span class='strut'>&nbsp;</span></p>
-<p id='t109' class='stm mis'>&nbsp; &nbsp; <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>save_json_dict</span><span class='op'>(</span><span class='nam'>CREDENTIALS_FILE</span><span class='op'>,</span> <span class='nam'>credentials</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t110' class='stm mis'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what we just put there is OK</span><span class='strut'>&nbsp;</span></p>
-<p id='t111' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t112' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t113' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_credentials_file</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t114' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Return specified args from `~/.plotly_credentials`. as dict.</span><span class='strut'>&nbsp;</span></p>
+<p id='t92' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>set_credentials_file</span><span class='op'>(</span><span class='nam'>username</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>api_key</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>stream_ids</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t93' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Set the keyword-value pairs in `~/.plotly_credentials`.</span><span class='strut'>&nbsp;</span></p>
+<p id='t94' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t95' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t96' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>_file_permissions</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t97' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;You don&#39;t have proper file permissions &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t98' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;to run this function.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t99' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
+<p id='t100' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>credentials</span> <span class='op'>=</span> <span class='nam'>get_credentials_file</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t101' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>username</span><span class='op'>,</span> <span class='nam'>six</span><span class='op'>.</span><span class='nam'>string_types</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t102' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>credentials</span><span class='op'>[</span><span class='str'>&#39;username&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>username</span><span class='strut'>&nbsp;</span></p>
+<p id='t103' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>api_key</span><span class='op'>,</span> <span class='nam'>six</span><span class='op'>.</span><span class='nam'>string_types</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t104' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>credentials</span><span class='op'>[</span><span class='str'>&#39;api_key&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>api_key</span><span class='strut'>&nbsp;</span></p>
+<p id='t105' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>stream_ids</span><span class='op'>,</span> <span class='op'>(</span><span class='nam'>list</span><span class='op'>,</span> <span class='nam'>tuple</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t106' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>credentials</span><span class='op'>[</span><span class='str'>&#39;stream_ids&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>stream_ids</span><span class='strut'>&nbsp;</span></p>
+<p id='t107' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>save_json_dict</span><span class='op'>(</span><span class='nam'>CREDENTIALS_FILE</span><span class='op'>,</span> <span class='nam'>credentials</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t108' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what we just put there is OK</span><span class='strut'>&nbsp;</span></p>
+<p id='t109' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t110' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t111' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_credentials_file</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t112' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Return specified args from `~/.plotly_credentials`. as dict.</span><span class='strut'>&nbsp;</span></p>
+<p id='t113' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t114' class='pln'><span class='str'>&nbsp; &nbsp; Returns all if no arguments are specified.</span><span class='strut'>&nbsp;</span></p>
 <p id='t115' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t116' class='pln'><span class='str'>&nbsp; &nbsp; Returns all if no arguments are specified.</span><span class='strut'>&nbsp;</span></p>
-<p id='t117' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t118' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t119' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; get_credentials_file(&#39;username&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t120' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t121' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t122' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>_file_permissions</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t123' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
-<p id='t124' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>load_json_dict</span><span class='op'>(</span><span class='nam'>CREDENTIALS_FILE</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t125' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t126' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>_FILE_CONTENT</span><span class='op'>[</span><span class='nam'>CREDENTIALS_FILE</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t127' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t128' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t129' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>reset_credentials_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t130' class='stm mis'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
-<p id='t131' class='stm mis'>&nbsp; &nbsp; <span class='nam'>f</span> <span class='op'>=</span> <span class='nam'>open</span><span class='op'>(</span><span class='nam'>CREDENTIALS_FILE</span><span class='op'>,</span> <span class='str'>&#39;w&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t132' class='stm mis'>&nbsp; &nbsp; <span class='nam'>f</span><span class='op'>.</span><span class='nam'>close</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t133' class='stm mis'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># put the defaults back</span><span class='strut'>&nbsp;</span></p>
-<p id='t134' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t116' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t117' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; get_credentials_file(&#39;username&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t118' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t119' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t120' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>_file_permissions</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t121' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
+<p id='t122' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>load_json_dict</span><span class='op'>(</span><span class='nam'>CREDENTIALS_FILE</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t123' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t124' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>_FILE_CONTENT</span><span class='op'>[</span><span class='nam'>CREDENTIALS_FILE</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t125' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t126' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t127' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>reset_credentials_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t128' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
+<p id='t129' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>f</span> <span class='op'>=</span> <span class='nam'>open</span><span class='op'>(</span><span class='nam'>CREDENTIALS_FILE</span><span class='op'>,</span> <span class='str'>&#39;w&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t130' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>f</span><span class='op'>.</span><span class='nam'>close</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t131' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># put the defaults back</span><span class='strut'>&nbsp;</span></p>
+<p id='t132' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t133' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t134' class='pln'><span class='com'>### config tools ###</span><span class='strut'>&nbsp;</span></p>
 <p id='t135' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t136' class='pln'><span class='com'># def show_credentials_file(*args):&nbsp; # TODO, can we lose this?</span><span class='strut'>&nbsp;</span></p>
-<p id='t137' class='pln'><span class='com'>#&nbsp; &nbsp;&nbsp; &quot;&quot;&quot;Print specified kwargs from `~/.plotly_credentials`.</span><span class='strut'>&nbsp;</span></p>
-<p id='t138' class='pln'><span class='com'>#</span><span class='strut'>&nbsp;</span></p>
-<p id='t139' class='pln'><span class='com'>#&nbsp; &nbsp;&nbsp; Prints all if no keyword arguments are specified.</span><span class='strut'>&nbsp;</span></p>
-<p id='t140' class='pln'><span class='com'>#</span><span class='strut'>&nbsp;</span></p>
-<p id='t141' class='pln'><span class='com'>#&nbsp; &nbsp;&nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t142' class='pln'><span class='com'>#&nbsp; &nbsp;&nbsp; ensure_local_plotly_files() # make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
-<p id='t143' class='pln'><span class='com'>#&nbsp; &nbsp;&nbsp; credentials = get_credentials_file(*args)</span><span class='strut'>&nbsp;</span></p>
-<p id='t144' class='pln'><span class='com'>#&nbsp; &nbsp;&nbsp; if len(args):</span><span class='strut'>&nbsp;</span></p>
-<p id='t145' class='pln'><span class='com'>#&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; print &quot;The specified keys from your credentials file:\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t146' class='pln'><span class='com'>#&nbsp; &nbsp;&nbsp; else:</span><span class='strut'>&nbsp;</span></p>
-<p id='t147' class='pln'><span class='com'>#&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; print &quot;Your credentials file:\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t148' class='pln'><span class='com'>#&nbsp; &nbsp;&nbsp; for key, val in credentials.items():</span><span class='strut'>&nbsp;</span></p>
-<p id='t149' class='pln'><span class='com'>#&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; print &quot;\t{}: {}&quot;.format(key, val).expandtabs()</span><span class='strut'>&nbsp;</span></p>
-<p id='t150' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t136' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>set_config_file</span><span class='op'>(</span><span class='nam'>plotly_domain</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>plotly_streaming_domain</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t137' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Set the keyword-value pairs in `~/.plotly/.config`.</span><span class='strut'>&nbsp;</span></p>
+<p id='t138' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t139' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t140' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>_file_permissions</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t141' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;You don&#39;t have proper file permissions &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t142' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;to run this function.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t143' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
+<p id='t144' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>settings</span> <span class='op'>=</span> <span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t145' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>plotly_domain</span><span class='op'>,</span> <span class='nam'>six</span><span class='op'>.</span><span class='nam'>string_types</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t146' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>settings</span><span class='op'>[</span><span class='str'>&#39;plotly_domain&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>plotly_domain</span><span class='strut'>&nbsp;</span></p>
+<p id='t147' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>plotly_streaming_domain</span><span class='op'>,</span> <span class='nam'>six</span><span class='op'>.</span><span class='nam'>string_types</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t148' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>settings</span><span class='op'>[</span><span class='str'>&#39;plotly_streaming_domain&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>plotly_streaming_domain</span><span class='strut'>&nbsp;</span></p>
+<p id='t149' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>save_json_dict</span><span class='op'>(</span><span class='nam'>CONFIG_FILE</span><span class='op'>,</span> <span class='nam'>settings</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t150' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what we just put there is OK</span><span class='strut'>&nbsp;</span></p>
 <p id='t151' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t152' class='pln'><span class='com'>### config tools ###</span><span class='strut'>&nbsp;</span></p>
-<p id='t153' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t154' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>set_config_file</span><span class='op'>(</span><span class='nam'>plotly_domain</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>plotly_streaming_domain</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t155' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Set the keyword-value pairs in `~/.plotly/.config`.</span><span class='strut'>&nbsp;</span></p>
-<p id='t156' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t157' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t158' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>_file_permissions</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t159' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='str'>&quot;You don&#39;t have proper file permissions &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t160' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;to run this function.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t161' class='stm mis'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
-<p id='t162' class='stm mis'>&nbsp; &nbsp; <span class='nam'>settings</span> <span class='op'>=</span> <span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t163' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>plotly_domain</span><span class='op'>,</span> <span class='nam'>str</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t164' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>settings</span><span class='op'>[</span><span class='str'>&#39;plotly_domain&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>plotly_domain</span><span class='strut'>&nbsp;</span></p>
-<p id='t165' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>plotly_streaming_domain</span><span class='op'>,</span> <span class='nam'>str</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t166' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>settings</span><span class='op'>[</span><span class='str'>&#39;plotly_streaming_domain&#39;</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>plotly_streaming_domain</span><span class='strut'>&nbsp;</span></p>
-<p id='t167' class='stm mis'>&nbsp; &nbsp; <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>save_json_dict</span><span class='op'>(</span><span class='nam'>CONFIG_FILE</span><span class='op'>,</span> <span class='nam'>settings</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t168' class='stm mis'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what we just put there is OK</span><span class='strut'>&nbsp;</span></p>
-<p id='t169' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t170' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t171' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t172' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Return specified args from `~/.plotly_credentials`. as dict.</span><span class='strut'>&nbsp;</span></p>
-<p id='t173' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t174' class='pln'><span class='str'>&nbsp; &nbsp; Returns all if no arguments are specified.</span><span class='strut'>&nbsp;</span></p>
+<p id='t152' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t153' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>*</span><span class='nam'>args</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t154' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Return specified args from `~/.plotly_credentials`. as dict.</span><span class='strut'>&nbsp;</span></p>
+<p id='t155' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t156' class='pln'><span class='str'>&nbsp; &nbsp; Returns all if no arguments are specified.</span><span class='strut'>&nbsp;</span></p>
+<p id='t157' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t158' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
+<p id='t159' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; get_credentials_file(&#39;username&#39;)</span><span class='strut'>&nbsp;</span></p>
+<p id='t160' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t161' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t162' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>_file_permissions</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t163' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
+<p id='t164' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>load_json_dict</span><span class='op'>(</span><span class='nam'>CONFIG_FILE</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t165' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t166' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>_FILE_CONTENT</span><span class='op'>[</span><span class='nam'>CONFIG_FILE</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t167' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t168' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t169' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>reset_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t170' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
+<p id='t171' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>f</span> <span class='op'>=</span> <span class='nam'>open</span><span class='op'>(</span><span class='nam'>CONFIG_FILE</span><span class='op'>,</span> <span class='str'>&#39;w&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t172' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>f</span><span class='op'>.</span><span class='nam'>close</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t173' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># put the defaults back</span><span class='strut'>&nbsp;</span></p>
+<p id='t174' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t175' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t176' class='pln'><span class='str'>&nbsp; &nbsp; Example:</span><span class='strut'>&nbsp;</span></p>
-<p id='t177' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; get_credentials_file(&#39;username&#39;)</span><span class='strut'>&nbsp;</span></p>
-<p id='t178' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t179' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t180' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>_file_permissions</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t181' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
-<p id='t182' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>utils</span><span class='op'>.</span><span class='nam'>load_json_dict</span><span class='op'>(</span><span class='nam'>CONFIG_FILE</span><span class='op'>,</span> <span class='op'>*</span><span class='nam'>args</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t183' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t184' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>_FILE_CONTENT</span><span class='op'>[</span><span class='nam'>CONFIG_FILE</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t185' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t186' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t187' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>reset_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t188' class='stm mis'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># make sure what&#39;s there is OK</span><span class='strut'>&nbsp;</span></p>
-<p id='t189' class='stm mis'>&nbsp; &nbsp; <span class='nam'>f</span> <span class='op'>=</span> <span class='nam'>open</span><span class='op'>(</span><span class='nam'>CONFIG_FILE</span><span class='op'>,</span> <span class='str'>&#39;w&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t190' class='stm mis'>&nbsp; &nbsp; <span class='nam'>f</span><span class='op'>.</span><span class='nam'>close</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t191' class='stm mis'>&nbsp; &nbsp; <span class='nam'>ensure_local_plotly_files</span><span class='op'>(</span><span class='op'>)</span>&nbsp; <span class='com'># put the defaults back</span><span class='strut'>&nbsp;</span></p>
+<p id='t176' class='pln'><span class='com'>### embed tools ###</span><span class='strut'>&nbsp;</span></p>
+<p id='t177' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t178' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_embed</span><span class='op'>(</span><span class='nam'>file_owner_or_url</span><span class='op'>,</span> <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>=</span><span class='str'>&quot;100%&quot;</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>=</span><span class='num'>525</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t179' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns HTML code to embed figure on a webpage as an &lt;iframe&gt;</span><span class='strut'>&nbsp;</span></p>
+<p id='t180' class='pln'><span class='str'>&nbsp; &nbsp; </span><span class='strut'>&nbsp;</span></p>
+<p id='t181' class='pln'><span class='str'>&nbsp; &nbsp; Plotly uniquely identifies figures with a &#39;file_owner&#39;/&#39;file_id&#39; pair.</span><span class='strut'>&nbsp;</span></p>
+<p id='t182' class='pln'><span class='str'>&nbsp; &nbsp; Since each file is given a corresponding unique url, you may also simply</span><span class='strut'>&nbsp;</span></p>
+<p id='t183' class='pln'><span class='str'>&nbsp; &nbsp; pass a valid plotly url as the first argument.</span><span class='strut'>&nbsp;</span></p>
+<p id='t184' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t185' class='pln'><span class='str'>&nbsp; &nbsp; Note, if you&#39;re using a file_owner string as the first argument, you MUST</span><span class='strut'>&nbsp;</span></p>
+<p id='t186' class='pln'><span class='str'>&nbsp; &nbsp; specify a `file_id` keyword argument. Else, if you&#39;re using a url string</span><span class='strut'>&nbsp;</span></p>
+<p id='t187' class='pln'><span class='str'>&nbsp; &nbsp; as the first argument, you MUST NOT specify a `file_id` keyword argument, or</span><span class='strut'>&nbsp;</span></p>
+<p id='t188' class='pln'><span class='str'>&nbsp; &nbsp; file_id must be set to Python&#39;s None value.</span><span class='strut'>&nbsp;</span></p>
+<p id='t189' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t190' class='pln'><span class='str'>&nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t191' class='pln'><span class='str'>&nbsp; &nbsp; file_owner_or_url (string) -- a valid plotly username OR a valid plotly url</span><span class='strut'>&nbsp;</span></p>
 <p id='t192' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t193' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t194' class='pln'><span class='com'>### embed tools ###</span><span class='strut'>&nbsp;</span></p>
-<p id='t195' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t196' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_embed</span><span class='op'>(</span><span class='nam'>file_owner_or_url</span><span class='op'>,</span> <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>=</span><span class='str'>&quot;100%&quot;</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>=</span><span class='num'>525</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t197' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns HTML code to embed figure on a webpage as an &lt;iframe&gt;</span><span class='strut'>&nbsp;</span></p>
-<p id='t198' class='pln'><span class='str'>&nbsp; &nbsp; </span><span class='strut'>&nbsp;</span></p>
-<p id='t199' class='pln'><span class='str'>&nbsp; &nbsp; Plotly uniquely identifies figures with a &#39;file_owner&#39;/&#39;file_id&#39; pair.</span><span class='strut'>&nbsp;</span></p>
-<p id='t200' class='pln'><span class='str'>&nbsp; &nbsp; Since each file is given a corresponding unique url, you may also simply</span><span class='strut'>&nbsp;</span></p>
-<p id='t201' class='pln'><span class='str'>&nbsp; &nbsp; pass a valid plotly url as the first argument.</span><span class='strut'>&nbsp;</span></p>
-<p id='t202' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t203' class='pln'><span class='str'>&nbsp; &nbsp; Note, if you&#39;re using a file_owner string as the first argument, you MUST</span><span class='strut'>&nbsp;</span></p>
-<p id='t204' class='pln'><span class='str'>&nbsp; &nbsp; specify a `file_id` keyword argument. Else, if you&#39;re using a url string</span><span class='strut'>&nbsp;</span></p>
-<p id='t205' class='pln'><span class='str'>&nbsp; &nbsp; as the first argument, you MUST NOT specify a `file_id` keyword argument, or</span><span class='strut'>&nbsp;</span></p>
-<p id='t206' class='pln'><span class='str'>&nbsp; &nbsp; file_id must be set to Python&#39;s None value.</span><span class='strut'>&nbsp;</span></p>
-<p id='t207' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t208' class='pln'><span class='str'>&nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t209' class='pln'><span class='str'>&nbsp; &nbsp; file_owner_or_url (string) -- a valid plotly username OR a valid plotly url</span><span class='strut'>&nbsp;</span></p>
-<p id='t210' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t211' class='pln'><span class='str'>&nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t212' class='pln'><span class='str'>&nbsp; &nbsp; file_id (default=None) -- an int or string that can be converted to int</span><span class='strut'>&nbsp;</span></p>
-<p id='t213' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; if you&#39;re using a url, don&#39;t fill this in!</span><span class='strut'>&nbsp;</span></p>
-<p id='t214' class='pln'><span class='str'>&nbsp; &nbsp; width (default=&quot;100%&quot;) -- an int or string corresp. to width of the figure</span><span class='strut'>&nbsp;</span></p>
-<p id='t215' class='pln'><span class='str'>&nbsp; &nbsp; height (default=&quot;525&quot;) -- same as width but corresp. to the height of the figure</span><span class='strut'>&nbsp;</span></p>
-<p id='t216' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t217' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t218' class='stm mis'>&nbsp; &nbsp; <span class='nam'>padding</span> <span class='op'>=</span> <span class='num'>25</span><span class='strut'>&nbsp;</span></p>
-<p id='t219' class='stm mis'>&nbsp; &nbsp; <span class='nam'>plotly_rest_url</span> <span class='op'>=</span> <span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>[</span><span class='str'>&#39;plotly_domain&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t220' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>file_id</span> <span class='key'>is</span> <span class='nam'>None</span><span class='op'>:</span>&nbsp; <span class='com'># assume we&#39;re using a url</span><span class='strut'>&nbsp;</span></p>
-<p id='t221' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>url</span> <span class='op'>=</span> <span class='nam'>file_owner_or_url</span><span class='strut'>&nbsp;</span></p>
-<p id='t222' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>url</span><span class='op'>[</span><span class='op'>:</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>plotly_rest_url</span><span class='op'>)</span><span class='op'>]</span> <span class='op'>!=</span> <span class='nam'>plotly_rest_url</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t223' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t224' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Because you didn&#39;t supply a &#39;file_id&#39; in the call, &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t225' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;we&#39;re assuming you&#39;re trying to snag a figure from a url. &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t226' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;You supplied the url, &#39;{}&#39;, we expected it to start with &#39;{}&#39;.&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t227' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;\nRun help on this function for more information.&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t228' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>url</span><span class='op'>,</span> <span class='nam'>plotly_rest_url</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t229' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>head</span> <span class='op'>=</span> <span class='nam'>plotly_rest_url</span> <span class='op'>+</span> <span class='str'>&quot;/~&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t230' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_owner</span> <span class='op'>=</span> <span class='nam'>url</span><span class='op'>.</span><span class='nam'>replace</span><span class='op'>(</span><span class='nam'>head</span><span class='op'>,</span> <span class='str'>&quot;&quot;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>split</span><span class='op'>(</span><span class='str'>&#39;/&#39;</span><span class='op'>)</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t231' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_id</span> <span class='op'>=</span> <span class='nam'>url</span><span class='op'>.</span><span class='nam'>replace</span><span class='op'>(</span><span class='nam'>head</span><span class='op'>,</span> <span class='str'>&quot;&quot;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>split</span><span class='op'>(</span><span class='str'>&#39;/&#39;</span><span class='op'>)</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t232' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t233' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_owner</span> <span class='op'>=</span> <span class='nam'>file_owner_or_url</span><span class='strut'>&nbsp;</span></p>
-<p id='t234' class='stm mis'>&nbsp; &nbsp; <span class='nam'>resource</span> <span class='op'>=</span> <span class='str'>&quot;/apigetfile/{file_owner}/{file_id}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>file_owner</span><span class='op'>=</span><span class='nam'>file_owner</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t235' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>file_id</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t236' class='stm mis'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t237' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>test_if_int</span> <span class='op'>=</span> <span class='nam'>int</span><span class='op'>(</span><span class='nam'>file_id</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t238' class='stm mis'>&nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>ValueError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t239' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t240' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The &#39;file_id&#39; argument was not able to be converted into an &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t241' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;integer number. Make sure that the positional &#39;file_id&#39; argument &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t242' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;is a number that can be converted into an integer or a string &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t243' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;that can be converted into an integer.&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t244' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t245' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>int</span><span class='op'>(</span><span class='nam'>file_id</span><span class='op'>)</span> <span class='op'>&lt;</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t246' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t247' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The &#39;file_id&#39; argument must be a non-negative number.&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t248' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t249' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>width</span><span class='op'>,</span> <span class='nam'>int</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t250' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>s</span> <span class='op'>=</span> <span class='op'>(</span><span class='str'>&quot;&lt;iframe id=\&quot;igraph\&quot; scrolling=\&quot;no\&quot; style=\&quot;border:none;\&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t251' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;seamless=\&quot;seamless\&quot; &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t252' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;src=\&quot;{plotly_rest_url}/&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t253' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;~{file_owner}/{file_id}/{plot_width}/{plot_height}\&quot; &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t254' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;height=\&quot;{iframe_height}\&quot; width=\&quot;{iframe_width}\&quot;&gt;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t255' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;&lt;/iframe&gt;&quot;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t256' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plotly_rest_url</span><span class='op'>=</span><span class='nam'>plotly_rest_url</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t257' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_owner</span><span class='op'>=</span><span class='nam'>file_owner</span><span class='op'>,</span> <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>file_id</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t258' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plot_width</span><span class='op'>=</span><span class='nam'>width</span><span class='op'>-</span><span class='nam'>padding</span><span class='op'>,</span> <span class='nam'>plot_height</span><span class='op'>=</span><span class='nam'>height</span><span class='op'>-</span><span class='nam'>padding</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t259' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>iframe_height</span><span class='op'>=</span><span class='nam'>height</span><span class='op'>,</span> <span class='nam'>iframe_width</span><span class='op'>=</span><span class='nam'>width</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t260' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t261' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>s</span> <span class='op'>=</span> <span class='op'>(</span><span class='str'>&quot;&lt;iframe id=\&quot;igraph\&quot; scrolling=\&quot;no\&quot; style=\&quot;border:none;\&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t262' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;seamless=\&quot;seamless\&quot; &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t263' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;src=\&quot;{plotly_rest_url}/&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t264' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;~{file_owner}/{file_id}\&quot; &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t265' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;height=\&quot;{iframe_height}\&quot; width=\&quot;{iframe_width}\&quot;&gt;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t266' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;&lt;/iframe&gt;&quot;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t267' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plotly_rest_url</span><span class='op'>=</span><span class='nam'>plotly_rest_url</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t268' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_owner</span><span class='op'>=</span><span class='nam'>file_owner</span><span class='op'>,</span> <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>file_id</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t269' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>iframe_height</span><span class='op'>=</span><span class='nam'>height</span><span class='op'>,</span> <span class='nam'>iframe_width</span><span class='op'>=</span><span class='nam'>width</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t193' class='pln'><span class='str'>&nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t194' class='pln'><span class='str'>&nbsp; &nbsp; file_id (default=None) -- an int or string that can be converted to int</span><span class='strut'>&nbsp;</span></p>
+<p id='t195' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; if you&#39;re using a url, don&#39;t fill this in!</span><span class='strut'>&nbsp;</span></p>
+<p id='t196' class='pln'><span class='str'>&nbsp; &nbsp; width (default=&quot;100%&quot;) -- an int or string corresp. to width of the figure</span><span class='strut'>&nbsp;</span></p>
+<p id='t197' class='pln'><span class='str'>&nbsp; &nbsp; height (default=&quot;525&quot;) -- same as width but corresp. to the height of the figure</span><span class='strut'>&nbsp;</span></p>
+<p id='t198' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t199' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t200' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>padding</span> <span class='op'>=</span> <span class='num'>25</span><span class='strut'>&nbsp;</span></p>
+<p id='t201' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>plotly_rest_url</span> <span class='op'>=</span> <span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>[</span><span class='str'>&#39;plotly_domain&#39;</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t202' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>file_id</span> <span class='key'>is</span> <span class='nam'>None</span><span class='op'>:</span>&nbsp; <span class='com'># assume we&#39;re using a url</span><span class='strut'>&nbsp;</span></p>
+<p id='t203' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>url</span> <span class='op'>=</span> <span class='nam'>file_owner_or_url</span><span class='strut'>&nbsp;</span></p>
+<p id='t204' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>url</span><span class='op'>[</span><span class='op'>:</span><span class='nam'>len</span><span class='op'>(</span><span class='nam'>plotly_rest_url</span><span class='op'>)</span><span class='op'>]</span> <span class='op'>!=</span> <span class='nam'>plotly_rest_url</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t205' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t206' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Because you didn&#39;t supply a &#39;file_id&#39; in the call, &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t207' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;we&#39;re assuming you&#39;re trying to snag a figure from a url. &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t208' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;You supplied the url, &#39;{}&#39;, we expected it to start with &#39;{}&#39;.&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t209' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;\nRun help on this function for more information.&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t210' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>url</span><span class='op'>,</span> <span class='nam'>plotly_rest_url</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t211' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>head</span> <span class='op'>=</span> <span class='nam'>plotly_rest_url</span> <span class='op'>+</span> <span class='str'>&quot;/~&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t212' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_owner</span> <span class='op'>=</span> <span class='nam'>url</span><span class='op'>.</span><span class='nam'>replace</span><span class='op'>(</span><span class='nam'>head</span><span class='op'>,</span> <span class='str'>&quot;&quot;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>split</span><span class='op'>(</span><span class='str'>&#39;/&#39;</span><span class='op'>)</span><span class='op'>[</span><span class='num'>0</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t213' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_id</span> <span class='op'>=</span> <span class='nam'>url</span><span class='op'>.</span><span class='nam'>replace</span><span class='op'>(</span><span class='nam'>head</span><span class='op'>,</span> <span class='str'>&quot;&quot;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>split</span><span class='op'>(</span><span class='str'>&#39;/&#39;</span><span class='op'>)</span><span class='op'>[</span><span class='num'>1</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t214' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t215' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_owner</span> <span class='op'>=</span> <span class='nam'>file_owner_or_url</span><span class='strut'>&nbsp;</span></p>
+<p id='t216' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>resource</span> <span class='op'>=</span> <span class='str'>&quot;/apigetfile/{file_owner}/{file_id}&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>file_owner</span><span class='op'>=</span><span class='nam'>file_owner</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t217' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>file_id</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t218' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t219' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>test_if_int</span> <span class='op'>=</span> <span class='nam'>int</span><span class='op'>(</span><span class='nam'>file_id</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t220' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>ValueError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t221' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t222' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The &#39;file_id&#39; argument was not able to be converted into an &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t223' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;integer number. Make sure that the positional &#39;file_id&#39; argument &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t224' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;is a number that can be converted into an integer or a string &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t225' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;that can be converted into an integer.&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t226' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t227' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>int</span><span class='op'>(</span><span class='nam'>file_id</span><span class='op'>)</span> <span class='op'>&lt;</span> <span class='num'>0</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t228' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t229' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The &#39;file_id&#39; argument must be a non-negative number.&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t230' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t231' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>width</span><span class='op'>,</span> <span class='nam'>int</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t232' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>s</span> <span class='op'>=</span> <span class='op'>(</span><span class='str'>&quot;&lt;iframe id=\&quot;igraph\&quot; scrolling=\&quot;no\&quot; style=\&quot;border:none;\&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t233' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;seamless=\&quot;seamless\&quot; &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t234' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;src=\&quot;{plotly_rest_url}/&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t235' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;~{file_owner}/{file_id}/{plot_width}/{plot_height}\&quot; &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t236' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;height=\&quot;{iframe_height}\&quot; width=\&quot;{iframe_width}\&quot;&gt;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t237' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;&lt;/iframe&gt;&quot;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t238' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plotly_rest_url</span><span class='op'>=</span><span class='nam'>plotly_rest_url</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t239' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_owner</span><span class='op'>=</span><span class='nam'>file_owner</span><span class='op'>,</span> <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>file_id</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t240' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plot_width</span><span class='op'>=</span><span class='nam'>width</span><span class='op'>-</span><span class='nam'>padding</span><span class='op'>,</span> <span class='nam'>plot_height</span><span class='op'>=</span><span class='nam'>height</span><span class='op'>-</span><span class='nam'>padding</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t241' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>iframe_height</span><span class='op'>=</span><span class='nam'>height</span><span class='op'>,</span> <span class='nam'>iframe_width</span><span class='op'>=</span><span class='nam'>width</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t242' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t243' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>s</span> <span class='op'>=</span> <span class='op'>(</span><span class='str'>&quot;&lt;iframe id=\&quot;igraph\&quot; scrolling=\&quot;no\&quot; style=\&quot;border:none;\&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t244' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;seamless=\&quot;seamless\&quot; &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t245' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;src=\&quot;{plotly_rest_url}/&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t246' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;~{file_owner}/{file_id}\&quot; &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t247' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;height=\&quot;{iframe_height}\&quot; width=\&quot;{iframe_width}\&quot;&gt;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t248' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='str'>&quot;&lt;/iframe&gt;&quot;</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t249' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plotly_rest_url</span><span class='op'>=</span><span class='nam'>plotly_rest_url</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t250' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>file_owner</span><span class='op'>=</span><span class='nam'>file_owner</span><span class='op'>,</span> <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>file_id</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t251' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>iframe_height</span><span class='op'>=</span><span class='nam'>height</span><span class='op'>,</span> <span class='nam'>iframe_width</span><span class='op'>=</span><span class='nam'>width</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t252' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t253' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>s</span><span class='strut'>&nbsp;</span></p>
+<p id='t254' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t255' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t256' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>embed</span><span class='op'>(</span><span class='nam'>file_owner_or_url</span><span class='op'>,</span> <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>=</span><span class='str'>&quot;100%&quot;</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>=</span><span class='num'>525</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t257' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Embeds existing Plotly figure in IPython Notebook</span><span class='strut'>&nbsp;</span></p>
+<p id='t258' class='pln'><span class='str'>&nbsp; &nbsp; </span><span class='strut'>&nbsp;</span></p>
+<p id='t259' class='pln'><span class='str'>&nbsp; &nbsp; Plotly uniquely identifies figures with a &#39;file_owner&#39;/&#39;file_id&#39; pair.</span><span class='strut'>&nbsp;</span></p>
+<p id='t260' class='pln'><span class='str'>&nbsp; &nbsp; Since each file is given a corresponding unique url, you may also simply</span><span class='strut'>&nbsp;</span></p>
+<p id='t261' class='pln'><span class='str'>&nbsp; &nbsp; pass a valid plotly url as the first argument.</span><span class='strut'>&nbsp;</span></p>
+<p id='t262' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t263' class='pln'><span class='str'>&nbsp; &nbsp; Note, if you&#39;re using a file_owner string as the first argument, you MUST</span><span class='strut'>&nbsp;</span></p>
+<p id='t264' class='pln'><span class='str'>&nbsp; &nbsp; specify a `file_id` keyword argument. Else, if you&#39;re using a url string</span><span class='strut'>&nbsp;</span></p>
+<p id='t265' class='pln'><span class='str'>&nbsp; &nbsp; as the first argument, you MUST NOT specify a `file_id` keyword argument, or</span><span class='strut'>&nbsp;</span></p>
+<p id='t266' class='pln'><span class='str'>&nbsp; &nbsp; file_id must be set to Python&#39;s None value.</span><span class='strut'>&nbsp;</span></p>
+<p id='t267' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t268' class='pln'><span class='str'>&nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t269' class='pln'><span class='str'>&nbsp; &nbsp; file_owner_or_url (string) -- a valid plotly username OR a valid plotly url</span><span class='strut'>&nbsp;</span></p>
 <p id='t270' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t271' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>s</span><span class='strut'>&nbsp;</span></p>
-<p id='t272' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t273' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t274' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>embed</span><span class='op'>(</span><span class='nam'>file_owner_or_url</span><span class='op'>,</span> <span class='nam'>file_id</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>=</span><span class='str'>&quot;100%&quot;</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>=</span><span class='num'>525</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t275' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Embeds existing Plotly figure in IPython Notebook</span><span class='strut'>&nbsp;</span></p>
-<p id='t276' class='pln'><span class='str'>&nbsp; &nbsp; </span><span class='strut'>&nbsp;</span></p>
-<p id='t277' class='pln'><span class='str'>&nbsp; &nbsp; Plotly uniquely identifies figures with a &#39;file_owner&#39;/&#39;file_id&#39; pair.</span><span class='strut'>&nbsp;</span></p>
-<p id='t278' class='pln'><span class='str'>&nbsp; &nbsp; Since each file is given a corresponding unique url, you may also simply</span><span class='strut'>&nbsp;</span></p>
-<p id='t279' class='pln'><span class='str'>&nbsp; &nbsp; pass a valid plotly url as the first argument.</span><span class='strut'>&nbsp;</span></p>
-<p id='t280' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t281' class='pln'><span class='str'>&nbsp; &nbsp; Note, if you&#39;re using a file_owner string as the first argument, you MUST</span><span class='strut'>&nbsp;</span></p>
-<p id='t282' class='pln'><span class='str'>&nbsp; &nbsp; specify a `file_id` keyword argument. Else, if you&#39;re using a url string</span><span class='strut'>&nbsp;</span></p>
-<p id='t283' class='pln'><span class='str'>&nbsp; &nbsp; as the first argument, you MUST NOT specify a `file_id` keyword argument, or</span><span class='strut'>&nbsp;</span></p>
-<p id='t284' class='pln'><span class='str'>&nbsp; &nbsp; file_id must be set to Python&#39;s None value.</span><span class='strut'>&nbsp;</span></p>
-<p id='t285' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t286' class='pln'><span class='str'>&nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t287' class='pln'><span class='str'>&nbsp; &nbsp; file_owner_or_url (string) -- a valid plotly username OR a valid plotly url</span><span class='strut'>&nbsp;</span></p>
-<p id='t288' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t289' class='pln'><span class='str'>&nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t290' class='pln'><span class='str'>&nbsp; &nbsp; file_id (default=None) -- an int or string that can be converted to int</span><span class='strut'>&nbsp;</span></p>
-<p id='t291' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; if you&#39;re using a url, don&#39;t fill this in!</span><span class='strut'>&nbsp;</span></p>
-<p id='t292' class='pln'><span class='str'>&nbsp; &nbsp; width (default=&quot;100%&quot;) -- an int or string corresp. to width of the figure</span><span class='strut'>&nbsp;</span></p>
-<p id='t293' class='pln'><span class='str'>&nbsp; &nbsp; height (default=&quot;525&quot;) -- same as width but corresp. to the height of the figure</span><span class='strut'>&nbsp;</span></p>
-<p id='t294' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t295' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t296' class='stm mis'>&nbsp; &nbsp; <span class='nam'>s</span> <span class='op'>=</span> <span class='nam'>get_embed</span><span class='op'>(</span><span class='nam'>file_owner_or_url</span><span class='op'>,</span> <span class='nam'>file_id</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t297' class='stm mis'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t298' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># see if we are in the SageMath Cloud</span><span class='strut'>&nbsp;</span></p>
-<p id='t299' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>from</span> <span class='nam'>sage_salvus</span> <span class='key'>import</span> <span class='nam'>html</span><span class='strut'>&nbsp;</span></p>
-<p id='t300' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>html</span><span class='op'>(</span><span class='nam'>s</span><span class='op'>,</span> <span class='nam'>hide</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t301' class='stm mis'>&nbsp; &nbsp; <span class='key'>except</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t302' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t303' class='stm mis'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t304' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>from</span> <span class='nam'>IPython</span><span class='op'>.</span><span class='nam'>display</span> <span class='key'>import</span> <span class='nam'>HTML</span><span class='op'>,</span> <span class='nam'>display</span><span class='strut'>&nbsp;</span></p>
-<p id='t305' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>display</span><span class='op'>(</span><span class='nam'>HTML</span><span class='op'>(</span><span class='nam'>s</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t306' class='stm mis'>&nbsp; &nbsp; <span class='key'>except</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t307' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t271' class='pln'><span class='str'>&nbsp; &nbsp; Keyword arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t272' class='pln'><span class='str'>&nbsp; &nbsp; file_id (default=None) -- an int or string that can be converted to int</span><span class='strut'>&nbsp;</span></p>
+<p id='t273' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; if you&#39;re using a url, don&#39;t fill this in!</span><span class='strut'>&nbsp;</span></p>
+<p id='t274' class='pln'><span class='str'>&nbsp; &nbsp; width (default=&quot;100%&quot;) -- an int or string corresp. to width of the figure</span><span class='strut'>&nbsp;</span></p>
+<p id='t275' class='pln'><span class='str'>&nbsp; &nbsp; height (default=&quot;525&quot;) -- same as width but corresp. to the height of the figure</span><span class='strut'>&nbsp;</span></p>
+<p id='t276' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t277' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t278' class='stm mis'>&nbsp; &nbsp; <span class='nam'>s</span> <span class='op'>=</span> <span class='nam'>get_embed</span><span class='op'>(</span><span class='nam'>file_owner_or_url</span><span class='op'>,</span> <span class='nam'>file_id</span><span class='op'>,</span> <span class='nam'>width</span><span class='op'>,</span> <span class='nam'>height</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t279' class='stm mis'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t280' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='com'># see if we are in the SageMath Cloud</span><span class='strut'>&nbsp;</span></p>
+<p id='t281' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>from</span> <span class='nam'>sage_salvus</span> <span class='key'>import</span> <span class='nam'>html</span><span class='strut'>&nbsp;</span></p>
+<p id='t282' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>html</span><span class='op'>(</span><span class='nam'>s</span><span class='op'>,</span> <span class='nam'>hide</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t283' class='stm mis'>&nbsp; &nbsp; <span class='key'>except</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t284' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t285' class='stm mis'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t286' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>from</span> <span class='nam'>IPython</span><span class='op'>.</span><span class='nam'>display</span> <span class='key'>import</span> <span class='nam'>HTML</span><span class='op'>,</span> <span class='nam'>display</span><span class='strut'>&nbsp;</span></p>
+<p id='t287' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>display</span><span class='op'>(</span><span class='nam'>HTML</span><span class='op'>(</span><span class='nam'>s</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t288' class='stm mis'>&nbsp; &nbsp; <span class='key'>except</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t289' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t290' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t291' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t292' class='pln'><span class='com'>### mpl-related tools ###</span><span class='strut'>&nbsp;</span></p>
+<p id='t293' class='stm run hide_run'><span class='op'>@</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>template_doc</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t294' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>mpl_to_plotly</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='nam'>resize</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span> <span class='nam'>strip_style</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span> <span class='nam'>verbose</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t295' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Convert a matplotlib figure to plotly dictionary and send.</span><span class='strut'>&nbsp;</span></p>
+<p id='t296' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t297' class='pln'><span class='str'>&nbsp; &nbsp; All available information about matplotlib visualizations are stored</span><span class='strut'>&nbsp;</span></p>
+<p id='t298' class='pln'><span class='str'>&nbsp; &nbsp; within a matplotlib.figure.Figure object. You can create a plot in python</span><span class='strut'>&nbsp;</span></p>
+<p id='t299' class='pln'><span class='str'>&nbsp; &nbsp; using matplotlib, store the figure object, and then pass this object to</span><span class='strut'>&nbsp;</span></p>
+<p id='t300' class='pln'><span class='str'>&nbsp; &nbsp; the fig_to_plotly function. In the background, mplexporter is used to</span><span class='strut'>&nbsp;</span></p>
+<p id='t301' class='pln'><span class='str'>&nbsp; &nbsp; crawl through the mpl figure object for appropriate information. This</span><span class='strut'>&nbsp;</span></p>
+<p id='t302' class='pln'><span class='str'>&nbsp; &nbsp; information is then systematically sent to the PlotlyRenderer which</span><span class='strut'>&nbsp;</span></p>
+<p id='t303' class='pln'><span class='str'>&nbsp; &nbsp; creates the JSON structure used to make plotly visualizations. Finally,</span><span class='strut'>&nbsp;</span></p>
+<p id='t304' class='pln'><span class='str'>&nbsp; &nbsp; these dictionaries are sent to plotly and your browser should open up a</span><span class='strut'>&nbsp;</span></p>
+<p id='t305' class='pln'><span class='str'>&nbsp; &nbsp; new tab for viewing! Optionally, if you&#39;re working in IPython, you can</span><span class='strut'>&nbsp;</span></p>
+<p id='t306' class='pln'><span class='str'>&nbsp; &nbsp; set notebook=True and the PlotlyRenderer will call plotly.iplot instead</span><span class='strut'>&nbsp;</span></p>
+<p id='t307' class='pln'><span class='str'>&nbsp; &nbsp; of plotly.plot to have the graph appear directly in the IPython notebook.</span><span class='strut'>&nbsp;</span></p>
 <p id='t308' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t309' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t310' class='pln'><span class='com'>### mpl-related tools ###</span><span class='strut'>&nbsp;</span></p>
-<p id='t311' class='stm run hide_run'><span class='op'>@</span><span class='nam'>utils</span><span class='op'>.</span><span class='nam'>template_doc</span><span class='op'>(</span><span class='op'>**</span><span class='nam'>get_config_file</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t312' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>mpl_to_plotly</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>,</span> <span class='nam'>resize</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span> <span class='nam'>strip_style</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>,</span> <span class='nam'>verbose</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t313' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Convert a matplotlib figure to plotly dictionary and send.</span><span class='strut'>&nbsp;</span></p>
-<p id='t314' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t315' class='pln'><span class='str'>&nbsp; &nbsp; All available information about matplotlib visualizations are stored</span><span class='strut'>&nbsp;</span></p>
-<p id='t316' class='pln'><span class='str'>&nbsp; &nbsp; within a matplotlib.figure.Figure object. You can create a plot in python</span><span class='strut'>&nbsp;</span></p>
-<p id='t317' class='pln'><span class='str'>&nbsp; &nbsp; using matplotlib, store the figure object, and then pass this object to</span><span class='strut'>&nbsp;</span></p>
-<p id='t318' class='pln'><span class='str'>&nbsp; &nbsp; the fig_to_plotly function. In the background, mplexporter is used to</span><span class='strut'>&nbsp;</span></p>
-<p id='t319' class='pln'><span class='str'>&nbsp; &nbsp; crawl through the mpl figure object for appropriate information. This</span><span class='strut'>&nbsp;</span></p>
-<p id='t320' class='pln'><span class='str'>&nbsp; &nbsp; information is then systematically sent to the PlotlyRenderer which</span><span class='strut'>&nbsp;</span></p>
-<p id='t321' class='pln'><span class='str'>&nbsp; &nbsp; creates the JSON structure used to make plotly visualizations. Finally,</span><span class='strut'>&nbsp;</span></p>
-<p id='t322' class='pln'><span class='str'>&nbsp; &nbsp; these dictionaries are sent to plotly and your browser should open up a</span><span class='strut'>&nbsp;</span></p>
-<p id='t323' class='pln'><span class='str'>&nbsp; &nbsp; new tab for viewing! Optionally, if you&#39;re working in IPython, you can</span><span class='strut'>&nbsp;</span></p>
-<p id='t324' class='pln'><span class='str'>&nbsp; &nbsp; set notebook=True and the PlotlyRenderer will call plotly.iplot instead</span><span class='strut'>&nbsp;</span></p>
-<p id='t325' class='pln'><span class='str'>&nbsp; &nbsp; of plotly.plot to have the graph appear directly in the IPython notebook.</span><span class='strut'>&nbsp;</span></p>
-<p id='t326' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t327' class='pln'><span class='str'>&nbsp; &nbsp; Note, this function gives the user access to a simple, one-line way to</span><span class='strut'>&nbsp;</span></p>
-<p id='t328' class='pln'><span class='str'>&nbsp; &nbsp; render an mpl figure in plotly. If you need to trouble shoot, you can do</span><span class='strut'>&nbsp;</span></p>
-<p id='t329' class='pln'><span class='str'>&nbsp; &nbsp; this step manually by NOT running this fuction and entereing the following:</span><span class='strut'>&nbsp;</span></p>
-<p id='t330' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t331' class='pln'><span class='str'>&nbsp; &nbsp; ============================================================================</span><span class='strut'>&nbsp;</span></p>
-<p id='t332' class='pln'><span class='str'>&nbsp; &nbsp; from mplexporter import Exporter</span><span class='strut'>&nbsp;</span></p>
-<p id='t333' class='pln'><span class='str'>&nbsp; &nbsp; from mplexporter.renderers import PlotlyRenderer</span><span class='strut'>&nbsp;</span></p>
+<p id='t309' class='pln'><span class='str'>&nbsp; &nbsp; Note, this function gives the user access to a simple, one-line way to</span><span class='strut'>&nbsp;</span></p>
+<p id='t310' class='pln'><span class='str'>&nbsp; &nbsp; render an mpl figure in plotly. If you need to trouble shoot, you can do</span><span class='strut'>&nbsp;</span></p>
+<p id='t311' class='pln'><span class='str'>&nbsp; &nbsp; this step manually by NOT running this fuction and entereing the following:</span><span class='strut'>&nbsp;</span></p>
+<p id='t312' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t313' class='pln'><span class='str'>&nbsp; &nbsp; ============================================================================</span><span class='strut'>&nbsp;</span></p>
+<p id='t314' class='pln'><span class='str'>&nbsp; &nbsp; from mplexporter import Exporter</span><span class='strut'>&nbsp;</span></p>
+<p id='t315' class='pln'><span class='str'>&nbsp; &nbsp; from mplexporter.renderers import PlotlyRenderer</span><span class='strut'>&nbsp;</span></p>
+<p id='t316' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t317' class='pln'><span class='str'>&nbsp; &nbsp; # create an mpl figure and store it under a varialble &#39;fig&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t318' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t319' class='pln'><span class='str'>&nbsp; &nbsp; renderer = PlotlyRenderer()</span><span class='strut'>&nbsp;</span></p>
+<p id='t320' class='pln'><span class='str'>&nbsp; &nbsp; exporter = Exporter(renderer)</span><span class='strut'>&nbsp;</span></p>
+<p id='t321' class='pln'><span class='str'>&nbsp; &nbsp; exporter.run(fig)</span><span class='strut'>&nbsp;</span></p>
+<p id='t322' class='pln'><span class='str'>&nbsp; &nbsp; ============================================================================</span><span class='strut'>&nbsp;</span></p>
+<p id='t323' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t324' class='pln'><span class='str'>&nbsp; &nbsp; You can then inspect the JSON structures by accessing these:</span><span class='strut'>&nbsp;</span></p>
+<p id='t325' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t326' class='pln'><span class='str'>&nbsp; &nbsp; renderer.layout -- a plotly layout dictionary</span><span class='strut'>&nbsp;</span></p>
+<p id='t327' class='pln'><span class='str'>&nbsp; &nbsp; renderer.data -- a list of plotly data dictionaries</span><span class='strut'>&nbsp;</span></p>
+<p id='t328' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t329' class='pln'><span class='str'>&nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
+<p id='t330' class='pln'><span class='str'>&nbsp; &nbsp; fig -- a matplotlib figure object</span><span class='strut'>&nbsp;</span></p>
+<p id='t331' class='pln'><span class='str'>&nbsp; &nbsp; username -- a valid plotly username **</span><span class='strut'>&nbsp;</span></p>
+<p id='t332' class='pln'><span class='str'>&nbsp; &nbsp; api_key -- a valid api_key for the above username **</span><span class='strut'>&nbsp;</span></p>
+<p id='t333' class='pln'><span class='str'>&nbsp; &nbsp; notebook -- an option for use with an IPython notebook</span><span class='strut'>&nbsp;</span></p>
 <p id='t334' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t335' class='pln'><span class='str'>&nbsp; &nbsp; # create an mpl figure and store it under a varialble &#39;fig&#39;</span><span class='strut'>&nbsp;</span></p>
-<p id='t336' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t337' class='pln'><span class='str'>&nbsp; &nbsp; renderer = PlotlyRenderer()</span><span class='strut'>&nbsp;</span></p>
-<p id='t338' class='pln'><span class='str'>&nbsp; &nbsp; exporter = Exporter(renderer)</span><span class='strut'>&nbsp;</span></p>
-<p id='t339' class='pln'><span class='str'>&nbsp; &nbsp; exporter.run(fig)</span><span class='strut'>&nbsp;</span></p>
-<p id='t340' class='pln'><span class='str'>&nbsp; &nbsp; ============================================================================</span><span class='strut'>&nbsp;</span></p>
-<p id='t341' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t342' class='pln'><span class='str'>&nbsp; &nbsp; You can then inspect the JSON structures by accessing these:</span><span class='strut'>&nbsp;</span></p>
-<p id='t343' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t344' class='pln'><span class='str'>&nbsp; &nbsp; renderer.layout -- a plotly layout dictionary</span><span class='strut'>&nbsp;</span></p>
-<p id='t345' class='pln'><span class='str'>&nbsp; &nbsp; renderer.data -- a list of plotly data dictionaries</span><span class='strut'>&nbsp;</span></p>
-<p id='t346' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t347' class='pln'><span class='str'>&nbsp; &nbsp; Positional arguments:</span><span class='strut'>&nbsp;</span></p>
-<p id='t348' class='pln'><span class='str'>&nbsp; &nbsp; fig -- a matplotlib figure object</span><span class='strut'>&nbsp;</span></p>
-<p id='t349' class='pln'><span class='str'>&nbsp; &nbsp; username -- a valid plotly username **</span><span class='strut'>&nbsp;</span></p>
-<p id='t350' class='pln'><span class='str'>&nbsp; &nbsp; api_key -- a valid api_key for the above username **</span><span class='strut'>&nbsp;</span></p>
-<p id='t351' class='pln'><span class='str'>&nbsp; &nbsp; notebook -- an option for use with an IPython notebook</span><span class='strut'>&nbsp;</span></p>
-<p id='t352' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t353' class='pln'><span class='str'>&nbsp; &nbsp; ** Don&#39;t have a username/api_key? Try looking here:</span><span class='strut'>&nbsp;</span></p>
-<p id='t354' class='pln'><span class='str'>&nbsp; &nbsp; {plotly_domain}/plot</span><span class='strut'>&nbsp;</span></p>
-<p id='t355' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t356' class='pln'><span class='str'>&nbsp; &nbsp; ** Forgot your api_key? Try signing in and looking here:</span><span class='strut'>&nbsp;</span></p>
-<p id='t357' class='pln'><span class='str'>&nbsp; &nbsp; {plotly_domain}/api/python/getting-started</span><span class='strut'>&nbsp;</span></p>
+<p id='t335' class='pln'><span class='str'>&nbsp; &nbsp; ** Don&#39;t have a username/api_key? Try looking here:</span><span class='strut'>&nbsp;</span></p>
+<p id='t336' class='pln'><span class='str'>&nbsp; &nbsp; {plotly_domain}/plot</span><span class='strut'>&nbsp;</span></p>
+<p id='t337' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t338' class='pln'><span class='str'>&nbsp; &nbsp; ** Forgot your api_key? Try signing in and looking here:</span><span class='strut'>&nbsp;</span></p>
+<p id='t339' class='pln'><span class='str'>&nbsp; &nbsp; {plotly_domain}/api/python/getting-started</span><span class='strut'>&nbsp;</span></p>
+<p id='t340' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t341' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t342' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>_matplotlylib_imported</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t343' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>renderer</span> <span class='op'>=</span> <span class='nam'>matplotlylib</span><span class='op'>.</span><span class='nam'>PlotlyRenderer</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t344' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>matplotlylib</span><span class='op'>.</span><span class='nam'>Exporter</span><span class='op'>(</span><span class='nam'>renderer</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>run</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t345' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>resize</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t346' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>renderer</span><span class='op'>.</span><span class='nam'>resize</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t347' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>strip_style</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t348' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>renderer</span><span class='op'>.</span><span class='nam'>strip_style</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t349' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>verbose</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t350' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>print</span><span class='op'>(</span><span class='nam'>renderer</span><span class='op'>.</span><span class='nam'>msg</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t351' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>renderer</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='strut'>&nbsp;</span></p>
+<p id='t352' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t353' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t354' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;To use Plotly&#39;s matplotlylib functionality, you&#39;ll need to have &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t355' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;matplotlib successfully installed with all of its dependencies. &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t356' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;You&#39;re getting this error because matplotlib or one of its &quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t357' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;dependencies doesn&#39;t seem to be installed correctly.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
 <p id='t358' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t359' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t360' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>_matplotlylib_imported</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t361' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>renderer</span> <span class='op'>=</span> <span class='nam'>matplotlylib</span><span class='op'>.</span><span class='nam'>PlotlyRenderer</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t362' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>matplotlylib</span><span class='op'>.</span><span class='nam'>Exporter</span><span class='op'>(</span><span class='nam'>renderer</span><span class='op'>)</span><span class='op'>.</span><span class='nam'>run</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t363' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>resize</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t364' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>renderer</span><span class='op'>.</span><span class='nam'>resize</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t365' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>strip_style</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t366' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>renderer</span><span class='op'>.</span><span class='nam'>strip_style</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t367' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>verbose</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t368' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>print</span><span class='op'>(</span><span class='nam'>renderer</span><span class='op'>.</span><span class='nam'>msg</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t369' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>renderer</span><span class='op'>.</span><span class='nam'>plotly_fig</span><span class='strut'>&nbsp;</span></p>
-<p id='t370' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t371' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t372' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;To use Plotly&#39;s matplotlylib functionality, you&#39;ll need to have &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t373' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;matplotlib successfully installed with all of its dependencies. &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t374' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;You&#39;re getting this error because matplotlib or one of its &quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t375' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;dependencies doesn&#39;t seem to be installed correctly.&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t359' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t360' class='pln'><span class='com'>### graph_objs related tools ###</span><span class='strut'>&nbsp;</span></p>
+<p id='t361' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t362' class='pln'><span class='com'># TODO: Scale spacing based on number of plots and figure size</span><span class='strut'>&nbsp;</span></p>
+<p id='t363' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_subplots</span><span class='op'>(</span><span class='nam'>rows</span><span class='op'>=</span><span class='num'>1</span><span class='op'>,</span> <span class='nam'>columns</span><span class='op'>=</span><span class='num'>1</span><span class='op'>,</span> <span class='nam'>horizontal_spacing</span><span class='op'>=</span><span class='num'>0.1</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
+<p id='t364' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>vertical_spacing</span><span class='op'>=</span><span class='num'>0.15</span><span class='op'>,</span> <span class='nam'>print_grid</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t365' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Return a dictionary instance with the subplots set in &#39;layout&#39;.</span><span class='strut'>&nbsp;</span></p>
+<p id='t366' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t367' class='pln'><span class='str'>&nbsp; &nbsp; Example 1:</span><span class='strut'>&nbsp;</span></p>
+<p id='t368' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; # stack two subplots vertically</span><span class='strut'>&nbsp;</span></p>
+<p id='t369' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; fig = tools.get_subplots(rows=2)</span><span class='strut'>&nbsp;</span></p>
+<p id='t370' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; fig[&#39;data&#39;] += [Scatter(x=[1,2,3], y=[2,1,2], xaxis=&#39;x1&#39;, yaxis=&#39;y1&#39;)]</span><span class='strut'>&nbsp;</span></p>
+<p id='t371' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; fig[&#39;data&#39;] += [Scatter(x=[1,2,3], y=[2,1,2], xaxis=&#39;x2&#39;, yaxis=&#39;y2&#39;)]</span><span class='strut'>&nbsp;</span></p>
+<p id='t372' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t373' class='pln'><span class='str'>&nbsp; &nbsp; Example 2:</span><span class='strut'>&nbsp;</span></p>
+<p id='t374' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; # print out string showing the subplot grid you&#39;ve put in the layout</span><span class='strut'>&nbsp;</span></p>
+<p id='t375' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; fig = tools.get_subplots(rows=3, columns=2, print_grid=True)</span><span class='strut'>&nbsp;</span></p>
 <p id='t376' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t377' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t378' class='pln'><span class='com'>### graph_objs related tools ###</span><span class='strut'>&nbsp;</span></p>
+<p id='t377' class='pln'><span class='str'>&nbsp; &nbsp; key (types, default=default):</span><span class='strut'>&nbsp;</span></p>
+<p id='t378' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; description.</span><span class='strut'>&nbsp;</span></p>
 <p id='t379' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t380' class='pln'><span class='com'># TODO: Scale spacing based on number of plots and figure size</span><span class='strut'>&nbsp;</span></p>
-<p id='t381' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_subplots</span><span class='op'>(</span><span class='nam'>rows</span><span class='op'>=</span><span class='num'>1</span><span class='op'>,</span> <span class='nam'>columns</span><span class='op'>=</span><span class='num'>1</span><span class='op'>,</span> <span class='nam'>horizontal_spacing</span><span class='op'>=</span><span class='num'>0.1</span><span class='op'>,</span><span class='strut'>&nbsp;</span></p>
-<p id='t382' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; <span class='nam'>vertical_spacing</span><span class='op'>=</span><span class='num'>0.15</span><span class='op'>,</span> <span class='nam'>print_grid</span><span class='op'>=</span><span class='nam'>False</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t383' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Return a dictionary instance with the subplots set in &#39;layout&#39;.</span><span class='strut'>&nbsp;</span></p>
-<p id='t384' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t385' class='pln'><span class='str'>&nbsp; &nbsp; Example 1:</span><span class='strut'>&nbsp;</span></p>
-<p id='t386' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; # stack two subplots vertically</span><span class='strut'>&nbsp;</span></p>
-<p id='t387' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; fig = tools.get_subplots(rows=2)</span><span class='strut'>&nbsp;</span></p>
-<p id='t388' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; fig[&#39;data&#39;] += [Scatter(x=[1,2,3], y=[2,1,2], xaxis=&#39;x1&#39;, yaxis=&#39;y1&#39;)]</span><span class='strut'>&nbsp;</span></p>
-<p id='t389' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; fig[&#39;data&#39;] += [Scatter(x=[1,2,3], y=[2,1,2], xaxis=&#39;x2&#39;, yaxis=&#39;y2&#39;)]</span><span class='strut'>&nbsp;</span></p>
-<p id='t390' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t391' class='pln'><span class='str'>&nbsp; &nbsp; Example 2:</span><span class='strut'>&nbsp;</span></p>
-<p id='t392' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; # print out string showing the subplot grid you&#39;ve put in the layout</span><span class='strut'>&nbsp;</span></p>
-<p id='t393' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; fig = tools.get_subplots(rows=3, columns=2, print_grid=True)</span><span class='strut'>&nbsp;</span></p>
+<p id='t380' class='pln'><span class='str'>&nbsp; &nbsp; rows (int, default=1):</span><span class='strut'>&nbsp;</span></p>
+<p id='t381' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Number of rows, evenly spaced vertically on the figure.</span><span class='strut'>&nbsp;</span></p>
+<p id='t382' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t383' class='pln'><span class='str'>&nbsp; &nbsp; columns (int, default=1):</span><span class='strut'>&nbsp;</span></p>
+<p id='t384' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Number of columns, evenly spaced horizontally on the figure.</span><span class='strut'>&nbsp;</span></p>
+<p id='t385' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t386' class='pln'><span class='str'>&nbsp; &nbsp; horizontal_spacing (float in [0,1], default=0.1):</span><span class='strut'>&nbsp;</span></p>
+<p id='t387' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Space between subplot columns. Applied to all columns.</span><span class='strut'>&nbsp;</span></p>
+<p id='t388' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t389' class='pln'><span class='str'>&nbsp; &nbsp; vertical_spacing (float in [0,1], default=0.05):</span><span class='strut'>&nbsp;</span></p>
+<p id='t390' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Space between subplot rows. Applied to all rows.</span><span class='strut'>&nbsp;</span></p>
+<p id='t391' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t392' class='pln'><span class='str'>&nbsp; &nbsp; print_grid (True | False, default=False):</span><span class='strut'>&nbsp;</span></p>
+<p id='t393' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; If True, prints a tab-delimited string representation of your plot grid.</span><span class='strut'>&nbsp;</span></p>
 <p id='t394' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t395' class='pln'><span class='str'>&nbsp; &nbsp; key (types, default=default):</span><span class='strut'>&nbsp;</span></p>
-<p id='t396' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; description.</span><span class='strut'>&nbsp;</span></p>
-<p id='t397' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t398' class='pln'><span class='str'>&nbsp; &nbsp; rows (int, default=1):</span><span class='strut'>&nbsp;</span></p>
-<p id='t399' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Number of rows, evenly spaced vertically on the figure.</span><span class='strut'>&nbsp;</span></p>
-<p id='t400' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t401' class='pln'><span class='str'>&nbsp; &nbsp; columns (int, default=1):</span><span class='strut'>&nbsp;</span></p>
-<p id='t402' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Number of columns, evenly spaced horizontally on the figure.</span><span class='strut'>&nbsp;</span></p>
-<p id='t403' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t404' class='pln'><span class='str'>&nbsp; &nbsp; horizontal_spacing (float in [0,1], default=0.1):</span><span class='strut'>&nbsp;</span></p>
-<p id='t405' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Space between subplot columns. Applied to all columns.</span><span class='strut'>&nbsp;</span></p>
+<p id='t395' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t396' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>fig</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='nam'>layout</span><span class='op'>=</span><span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>Layout</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span>&nbsp; <span class='com'># will return this at the end</span><span class='strut'>&nbsp;</span></p>
+<p id='t397' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>plot_width</span> <span class='op'>=</span> <span class='op'>(</span><span class='num'>1</span> <span class='op'>-</span> <span class='nam'>horizontal_spacing</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>columns</span> <span class='op'>-</span> <span class='num'>1</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>/</span> <span class='nam'>columns</span><span class='strut'>&nbsp;</span></p>
+<p id='t398' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>plot_height</span> <span class='op'>=</span> <span class='op'>(</span><span class='num'>1</span> <span class='op'>-</span> <span class='nam'>vertical_spacing</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>rows</span> <span class='op'>-</span> <span class='num'>1</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>/</span> <span class='nam'>rows</span><span class='strut'>&nbsp;</span></p>
+<p id='t399' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>plot_num</span> <span class='op'>=</span> <span class='num'>0</span><span class='strut'>&nbsp;</span></p>
+<p id='t400' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>rrr</span> <span class='key'>in</span> <span class='nam'>range</span><span class='op'>(</span><span class='nam'>rows</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t401' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>ccc</span> <span class='key'>in</span> <span class='nam'>range</span><span class='op'>(</span><span class='nam'>columns</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t402' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis_name</span> <span class='op'>=</span> <span class='str'>&#39;xaxis{}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>plot_num</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t403' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x_anchor</span> <span class='op'>=</span> <span class='str'>&#39;y{}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>plot_num</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t404' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x_start</span> <span class='op'>=</span> <span class='op'>(</span><span class='nam'>plot_width</span> <span class='op'>+</span> <span class='nam'>horizontal_spacing</span><span class='op'>)</span> <span class='op'>*</span> <span class='nam'>ccc</span><span class='strut'>&nbsp;</span></p>
+<p id='t405' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x_end</span> <span class='op'>=</span> <span class='nam'>x_start</span> <span class='op'>+</span> <span class='nam'>plot_width</span><span class='strut'>&nbsp;</span></p>
 <p id='t406' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t407' class='pln'><span class='str'>&nbsp; &nbsp; vertical_spacing (float in [0,1], default=0.05):</span><span class='strut'>&nbsp;</span></p>
-<p id='t408' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; Space between subplot rows. Applied to all rows.</span><span class='strut'>&nbsp;</span></p>
-<p id='t409' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t410' class='pln'><span class='str'>&nbsp; &nbsp; print_grid (True | False, default=False):</span><span class='strut'>&nbsp;</span></p>
-<p id='t411' class='pln'><span class='str'>&nbsp; &nbsp; &nbsp; &nbsp; If True, prints a tab-delimited string representation of your plot grid.</span><span class='strut'>&nbsp;</span></p>
-<p id='t412' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t413' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t414' class='stm mis'>&nbsp; &nbsp; <span class='nam'>fig</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='nam'>layout</span><span class='op'>=</span><span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>Layout</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span>&nbsp; <span class='com'># will return this at the end</span><span class='strut'>&nbsp;</span></p>
-<p id='t415' class='stm mis'>&nbsp; &nbsp; <span class='nam'>plot_width</span> <span class='op'>=</span> <span class='op'>(</span><span class='num'>1</span> <span class='op'>-</span> <span class='nam'>horizontal_spacing</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>columns</span> <span class='op'>-</span> <span class='num'>1</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>/</span> <span class='nam'>columns</span><span class='strut'>&nbsp;</span></p>
-<p id='t416' class='stm mis'>&nbsp; &nbsp; <span class='nam'>plot_height</span> <span class='op'>=</span> <span class='op'>(</span><span class='num'>1</span> <span class='op'>-</span> <span class='nam'>vertical_spacing</span> <span class='op'>*</span> <span class='op'>(</span><span class='nam'>rows</span> <span class='op'>-</span> <span class='num'>1</span><span class='op'>)</span><span class='op'>)</span> <span class='op'>/</span> <span class='nam'>rows</span><span class='strut'>&nbsp;</span></p>
-<p id='t417' class='stm mis'>&nbsp; &nbsp; <span class='nam'>plot_num</span> <span class='op'>=</span> <span class='num'>0</span><span class='strut'>&nbsp;</span></p>
-<p id='t418' class='stm mis'>&nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>rrr</span> <span class='key'>in</span> <span class='nam'>range</span><span class='op'>(</span><span class='nam'>rows</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t419' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>ccc</span> <span class='key'>in</span> <span class='nam'>range</span><span class='op'>(</span><span class='nam'>columns</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t420' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis_name</span> <span class='op'>=</span> <span class='str'>&#39;xaxis{}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>plot_num</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t421' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x_anchor</span> <span class='op'>=</span> <span class='str'>&#39;y{}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>plot_num</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t422' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x_start</span> <span class='op'>=</span> <span class='op'>(</span><span class='nam'>plot_width</span> <span class='op'>+</span> <span class='nam'>horizontal_spacing</span><span class='op'>)</span> <span class='op'>*</span> <span class='nam'>ccc</span><span class='strut'>&nbsp;</span></p>
-<p id='t423' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>x_end</span> <span class='op'>=</span> <span class='nam'>x_start</span> <span class='op'>+</span> <span class='nam'>plot_width</span><span class='strut'>&nbsp;</span></p>
-<p id='t424' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t425' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis_name</span> <span class='op'>=</span> <span class='str'>&#39;yaxis{}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>plot_num</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t426' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y_anchor</span> <span class='op'>=</span> <span class='str'>&#39;x{}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>plot_num</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t427' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y_start</span> <span class='op'>=</span> <span class='op'>(</span><span class='nam'>plot_height</span> <span class='op'>+</span> <span class='nam'>vertical_spacing</span><span class='op'>)</span> <span class='op'>*</span> <span class='nam'>rrr</span><span class='strut'>&nbsp;</span></p>
-<p id='t428' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y_end</span> <span class='op'>=</span> <span class='nam'>y_start</span> <span class='op'>+</span> <span class='nam'>plot_height</span><span class='strut'>&nbsp;</span></p>
+<p id='t407' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis_name</span> <span class='op'>=</span> <span class='str'>&#39;yaxis{}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>plot_num</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t408' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y_anchor</span> <span class='op'>=</span> <span class='str'>&#39;x{}&#39;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>plot_num</span> <span class='op'>+</span> <span class='num'>1</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t409' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y_start</span> <span class='op'>=</span> <span class='op'>(</span><span class='nam'>plot_height</span> <span class='op'>+</span> <span class='nam'>vertical_spacing</span><span class='op'>)</span> <span class='op'>*</span> <span class='nam'>rrr</span><span class='strut'>&nbsp;</span></p>
+<p id='t410' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>y_end</span> <span class='op'>=</span> <span class='nam'>y_start</span> <span class='op'>+</span> <span class='nam'>plot_height</span><span class='strut'>&nbsp;</span></p>
+<p id='t411' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t412' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>XAxis</span><span class='op'>(</span><span class='nam'>domain</span><span class='op'>=</span><span class='op'>[</span><span class='nam'>x_start</span><span class='op'>,</span> <span class='nam'>x_end</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>anchor</span><span class='op'>=</span><span class='nam'>x_anchor</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t413' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>xaxis_name</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>xaxis</span><span class='strut'>&nbsp;</span></p>
+<p id='t414' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>YAxis</span><span class='op'>(</span><span class='nam'>domain</span><span class='op'>=</span><span class='op'>[</span><span class='nam'>y_start</span><span class='op'>,</span> <span class='nam'>y_end</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>anchor</span><span class='op'>=</span><span class='nam'>y_anchor</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t415' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>yaxis_name</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>yaxis</span><span class='strut'>&nbsp;</span></p>
+<p id='t416' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plot_num</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
+<p id='t417' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>print_grid</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t418' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>print</span><span class='op'>(</span><span class='str'>&quot;This is the format of your plot grid!&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t419' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>grid_string</span> <span class='op'>=</span> <span class='str'>&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t420' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plot</span> <span class='op'>=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
+<p id='t421' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>rrr</span> <span class='key'>in</span> <span class='nam'>range</span><span class='op'>(</span><span class='nam'>rows</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t422' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>grid_line</span> <span class='op'>=</span> <span class='str'>&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t423' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>ccc</span> <span class='key'>in</span> <span class='nam'>range</span><span class='op'>(</span><span class='nam'>columns</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t424' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>grid_line</span> <span class='op'>+=</span> <span class='str'>&quot;[{}]\t&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>plot</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t425' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plot</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
+<p id='t426' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>grid_string</span> <span class='op'>=</span> <span class='nam'>grid_line</span> <span class='op'>+</span> <span class='str'>&#39;\n&#39;</span> <span class='op'>+</span> <span class='nam'>grid_string</span><span class='strut'>&nbsp;</span></p>
+<p id='t427' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>print</span><span class='op'>(</span><span class='nam'>grid_string</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t428' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>Figure</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>)</span>&nbsp; <span class='com'># forces us to validate what we just did...</span><span class='strut'>&nbsp;</span></p>
 <p id='t429' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t430' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>xaxis</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>XAxis</span><span class='op'>(</span><span class='nam'>domain</span><span class='op'>=</span><span class='op'>[</span><span class='nam'>x_start</span><span class='op'>,</span> <span class='nam'>x_end</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>anchor</span><span class='op'>=</span><span class='nam'>x_anchor</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t431' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>xaxis_name</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>xaxis</span><span class='strut'>&nbsp;</span></p>
-<p id='t432' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>yaxis</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>YAxis</span><span class='op'>(</span><span class='nam'>domain</span><span class='op'>=</span><span class='op'>[</span><span class='nam'>y_start</span><span class='op'>,</span> <span class='nam'>y_end</span><span class='op'>]</span><span class='op'>,</span> <span class='nam'>anchor</span><span class='op'>=</span><span class='nam'>y_anchor</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t433' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>fig</span><span class='op'>[</span><span class='str'>&#39;layout&#39;</span><span class='op'>]</span><span class='op'>[</span><span class='nam'>yaxis_name</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>yaxis</span><span class='strut'>&nbsp;</span></p>
-<p id='t434' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plot_num</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
-<p id='t435' class='stm mis'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>print_grid</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t436' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>print</span><span class='op'>(</span><span class='str'>&quot;This is the format of your plot grid!&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t437' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>grid_string</span> <span class='op'>=</span> <span class='str'>&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t438' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plot</span> <span class='op'>=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
-<p id='t439' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>rrr</span> <span class='key'>in</span> <span class='nam'>range</span><span class='op'>(</span><span class='nam'>rows</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t440' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>grid_line</span> <span class='op'>=</span> <span class='str'>&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t441' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>ccc</span> <span class='key'>in</span> <span class='nam'>range</span><span class='op'>(</span><span class='nam'>columns</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t442' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>grid_line</span> <span class='op'>+=</span> <span class='str'>&quot;[{}]\t&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='nam'>plot</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t443' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>plot</span> <span class='op'>+=</span> <span class='num'>1</span><span class='strut'>&nbsp;</span></p>
-<p id='t444' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>grid_string</span> <span class='op'>=</span> <span class='nam'>grid_line</span> <span class='op'>+</span> <span class='str'>&#39;\n&#39;</span> <span class='op'>+</span> <span class='nam'>grid_string</span><span class='strut'>&nbsp;</span></p>
-<p id='t445' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>print</span><span class='op'>(</span><span class='nam'>grid_string</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t446' class='stm mis'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>Figure</span><span class='op'>(</span><span class='nam'>fig</span><span class='op'>)</span>&nbsp; <span class='com'># forces us to validate what we just did...</span><span class='strut'>&nbsp;</span></p>
-<p id='t447' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t448' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t449' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_valid_graph_obj</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t450' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns a new graph object that is guaranteed to pass validate().</span><span class='strut'>&nbsp;</span></p>
-<p id='t451' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t452' class='pln'><span class='str'>&nbsp; &nbsp; CAREFUL: this will *silently* strip out invalid pieces of the object.</span><span class='strut'>&nbsp;</span></p>
+<p id='t430' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t431' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>get_valid_graph_obj</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='op'>=</span><span class='nam'>None</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t432' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Returns a new graph object that is guaranteed to pass validate().</span><span class='strut'>&nbsp;</span></p>
+<p id='t433' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t434' class='pln'><span class='str'>&nbsp; &nbsp; CAREFUL: this will *silently* strip out invalid pieces of the object.</span><span class='strut'>&nbsp;</span></p>
+<p id='t435' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t436' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t437' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t438' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>new_obj</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>obj</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t439' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t440' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t441' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>new_obj</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t442' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t443' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t444' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;{}&#39; nor &#39;{}&#39; are recognizable graph_objs.&quot;</span><span class='op'>.</span><span class='strut'>&nbsp;</span></p>
+<p id='t445' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>format</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t446' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>new_obj</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t447' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>new_obj</span> <span class='op'>+=</span> <span class='nam'>obj</span><span class='strut'>&nbsp;</span></p>
+<p id='t448' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t449' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t450' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>new_obj</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
+<p id='t451' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>new_obj</span><span class='op'>.</span><span class='nam'>force_clean</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t452' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>new_obj</span><span class='strut'>&nbsp;</span></p>
 <p id='t453' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t454' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t455' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t456' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>new_obj</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>obj</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>]</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t457' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t458' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t459' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>new_obj</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t460' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t461' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t462' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;{}&#39; nor &#39;{}&#39; are recognizable graph_objs.&quot;</span><span class='op'>.</span><span class='strut'>&nbsp;</span></p>
-<p id='t463' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>format</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>.</span><span class='nam'>__class__</span><span class='op'>.</span><span class='nam'>__name__</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t464' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>new_obj</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t465' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>new_obj</span> <span class='op'>+=</span> <span class='nam'>obj</span><span class='strut'>&nbsp;</span></p>
-<p id='t466' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t467' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t468' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>new_obj</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>val</span><span class='strut'>&nbsp;</span></p>
-<p id='t469' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>new_obj</span><span class='op'>.</span><span class='nam'>force_clean</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t470' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>new_obj</span><span class='strut'>&nbsp;</span></p>
-<p id='t471' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t472' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t473' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>validate</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t474' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Validate a dictionary, list, or graph object as &#39;obj_type&#39;.</span><span class='strut'>&nbsp;</span></p>
-<p id='t475' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t476' class='pln'><span class='str'>&nbsp; &nbsp; This will not alter the &#39;obj&#39; referenced in the call signature. It will</span><span class='strut'>&nbsp;</span></p>
-<p id='t477' class='pln'><span class='str'>&nbsp; &nbsp; raise an error if the &#39;obj&#39; reference could not be instantiated as a</span><span class='strut'>&nbsp;</span></p>
-<p id='t478' class='pln'><span class='str'>&nbsp; &nbsp; valid &#39;obj_type&#39; graph object.</span><span class='strut'>&nbsp;</span></p>
+<p id='t454' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t455' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>validate</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t456' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Validate a dictionary, list, or graph object as &#39;obj_type&#39;.</span><span class='strut'>&nbsp;</span></p>
+<p id='t457' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t458' class='pln'><span class='str'>&nbsp; &nbsp; This will not alter the &#39;obj&#39; referenced in the call signature. It will</span><span class='strut'>&nbsp;</span></p>
+<p id='t459' class='pln'><span class='str'>&nbsp; &nbsp; raise an error if the &#39;obj&#39; reference could not be instantiated as a</span><span class='strut'>&nbsp;</span></p>
+<p id='t460' class='pln'><span class='str'>&nbsp; &nbsp; valid &#39;obj_type&#39; graph object.</span><span class='strut'>&nbsp;</span></p>
+<p id='t461' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t462' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t463' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t464' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_type</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t465' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t466' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t467' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t468' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>test_obj</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t469' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t470' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t471' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;{}&#39; is not a recognizable graph_obj.&quot;</span><span class='op'>.</span><span class='strut'>&nbsp;</span></p>
+<p id='t472' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>format</span><span class='op'>(</span><span class='nam'>obj_type</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t473' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t474' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t475' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>validate_stream</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t476' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Validate a data dictionary (only) for use with streaming.</span><span class='strut'>&nbsp;</span></p>
+<p id='t477' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t478' class='pln'><span class='str'>&nbsp; &nbsp; An error is raised if a key within (or nested within) is not streamable.</span><span class='strut'>&nbsp;</span></p>
 <p id='t479' class='pln'><span class='strut'>&nbsp;</span></p>
 <p id='t480' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
 <p id='t481' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
 <p id='t482' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_type</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t483' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t484' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t485' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t486' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>test_obj</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>NAME_TO_CLASS</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t487' class='stm mis'>&nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t488' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t489' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;&#39;{}&#39; is not a recognizable graph_obj.&quot;</span><span class='op'>.</span><span class='strut'>&nbsp;</span></p>
-<p id='t490' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>format</span><span class='op'>(</span><span class='nam'>obj_type</span><span class='op'>)</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t491' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t492' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t493' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>validate_stream</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t494' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Validate a data dictionary (only) for use with streaming.</span><span class='strut'>&nbsp;</span></p>
-<p id='t495' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t496' class='pln'><span class='str'>&nbsp; &nbsp; An error is raised if a key within (or nested within) is not streamable.</span><span class='strut'>&nbsp;</span></p>
-<p id='t497' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t498' class='pln'><span class='str'>&nbsp; &nbsp; &quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t499' class='stm mis'>&nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t500' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>obj_type</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t501' class='stm mis'>&nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t502' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t503' class='stm mis'>&nbsp; &nbsp; <span class='nam'>info</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t504' class='stm mis'>&nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t505' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='op'>==</span> <span class='str'>&#39;type&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t506' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>continue</span><span class='strut'>&nbsp;</span></p>
-<p id='t507' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;streamable&#39;</span> <span class='key'>in</span> <span class='nam'>info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t508' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;streamable&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t509' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t510' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The &#39;{}&#39; key is not streamable in the &#39;{}&#39; object&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t511' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='strut'>&nbsp;</span></p>
-<p id='t512' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t513' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t514' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t515' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t516' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The &#39;{}&#39; key is not streamable in the &#39;{}&#39; object&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
-<p id='t517' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='strut'>&nbsp;</span></p>
-<p id='t518' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t519' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t520' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t521' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>sub_obj_type</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t522' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>validate_stream</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>,</span> <span class='nam'>sub_obj_type</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t523' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t524' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
-<p id='t525' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t526' class='pln'><span class='strut'>&nbsp;</span></p>
-<p id='t527' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>_replace_newline</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t528' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Replaces &#39;\n&#39; with &#39;&lt;br&gt;&#39; for all strings in a collection.&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t529' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t530' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t531' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t532' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>_replace_newline</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t533' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>d</span><span class='strut'>&nbsp;</span></p>
-<p id='t534' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t535' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>l</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t536' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t537' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>l</span> <span class='op'>+=</span> <span class='op'>[</span><span class='nam'>_replace_newline</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>)</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
-<p id='t538' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>l</span><span class='strut'>&nbsp;</span></p>
-<p id='t539' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>str</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t540' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>s</span> <span class='op'>=</span> <span class='nam'>obj</span><span class='op'>.</span><span class='nam'>replace</span><span class='op'>(</span><span class='str'>&#39;\n&#39;</span><span class='op'>,</span> <span class='str'>&#39;&lt;br&gt;&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t541' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>s</span> <span class='op'>!=</span> <span class='nam'>obj</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t542' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;Looks like you used a newline character: &#39;\\n&#39;.\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t543' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Plotly uses a subset of HTML escape characters\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t544' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;to do things like newline (&lt;br&gt;), bold (&lt;b&gt;&lt;/b&gt;),\n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t545' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;italics (&lt;i&gt;&lt;/i&gt;), etc. Your newline characters \n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t546' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;have been converted to &#39;&lt;br&gt;&#39; so they will show \n&quot;</span><span class='strut'>&nbsp;</span></p>
-<p id='t547' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;up right on your Plotly figure!&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
-<p id='t548' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>s</span><span class='strut'>&nbsp;</span></p>
-<p id='t549' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t550' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>obj</span>&nbsp; <span class='com'># we return the actual reference... but DON&#39;T mutate.</span><span class='strut'>&nbsp;</span></p>
+<p id='t483' class='stm mis'>&nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t484' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t485' class='stm run hide_run'>&nbsp; &nbsp; <span class='nam'>info</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>INFO</span><span class='op'>[</span><span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>NAME_TO_KEY</span><span class='op'>[</span><span class='nam'>obj_type</span><span class='op'>]</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t486' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t487' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>key</span> <span class='op'>==</span> <span class='str'>&#39;type&#39;</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t488' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>continue</span><span class='strut'>&nbsp;</span></p>
+<p id='t489' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='str'>&#39;streamable&#39;</span> <span class='key'>in</span> <span class='nam'>info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t490' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>info</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='op'>[</span><span class='str'>&#39;streamable&#39;</span><span class='op'>]</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t491' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t492' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The &#39;{}&#39; key is not streamable in the &#39;{}&#39; object&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t493' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='strut'>&nbsp;</span></p>
+<p id='t494' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t495' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t496' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t497' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>raise</span> <span class='nam'>exceptions</span><span class='op'>.</span><span class='nam'>PlotlyError</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t498' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;The &#39;{}&#39; key is not streamable in the &#39;{}&#39; object&quot;</span><span class='op'>.</span><span class='nam'>format</span><span class='op'>(</span><span class='strut'>&nbsp;</span></p>
+<p id='t499' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>obj_type</span><span class='strut'>&nbsp;</span></p>
+<p id='t500' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t501' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t502' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>try</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t503' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>sub_obj_type</span> <span class='op'>=</span> <span class='nam'>graph_objs</span><span class='op'>.</span><span class='nam'>KEY_TO_NAME</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t504' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>validate_stream</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>,</span> <span class='nam'>sub_obj_type</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t505' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span> <span class='nam'>KeyError</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t506' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span><span class='strut'>&nbsp;</span></p>
+<p id='t507' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t508' class='pln'><span class='strut'>&nbsp;</span></p>
+<p id='t509' class='stm run hide_run'><span class='key'>def</span> <span class='nam'>_replace_newline</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t510' class='pln'>&nbsp; &nbsp; <span class='str'>&quot;&quot;&quot;Replaces &#39;\n&#39; with &#39;&lt;br&gt;&#39; for all strings in a collection.&quot;&quot;&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t511' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t512' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t513' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span><span class='op'>,</span> <span class='nam'>val</span> <span class='key'>in</span> <span class='nam'>list</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>.</span><span class='nam'>items</span><span class='op'>(</span><span class='op'>)</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t514' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span><span class='op'>[</span><span class='nam'>key</span><span class='op'>]</span> <span class='op'>=</span> <span class='nam'>_replace_newline</span><span class='op'>(</span><span class='nam'>val</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t515' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>d</span><span class='strut'>&nbsp;</span></p>
+<p id='t516' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>list</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t517' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>l</span> <span class='op'>=</span> <span class='nam'>list</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t518' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>index</span><span class='op'>,</span> <span class='nam'>entry</span> <span class='key'>in</span> <span class='nam'>enumerate</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t519' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>l</span> <span class='op'>+=</span> <span class='op'>[</span><span class='nam'>_replace_newline</span><span class='op'>(</span><span class='nam'>entry</span><span class='op'>)</span><span class='op'>]</span><span class='strut'>&nbsp;</span></p>
+<p id='t520' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>l</span><span class='strut'>&nbsp;</span></p>
+<p id='t521' class='stm run hide_run'>&nbsp; &nbsp; <span class='key'>elif</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>obj</span><span class='op'>,</span> <span class='nam'>six</span><span class='op'>.</span><span class='nam'>string_types</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t522' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>s</span> <span class='op'>=</span> <span class='nam'>obj</span><span class='op'>.</span><span class='nam'>replace</span><span class='op'>(</span><span class='str'>&#39;\n&#39;</span><span class='op'>,</span> <span class='str'>&#39;&lt;br&gt;&#39;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t523' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>s</span> <span class='op'>!=</span> <span class='nam'>obj</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t524' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>warnings</span><span class='op'>.</span><span class='nam'>warn</span><span class='op'>(</span><span class='str'>&quot;Looks like you used a newline character: &#39;\\n&#39;.\n\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t525' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;Plotly uses a subset of HTML escape characters\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t526' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;to do things like newline (&lt;br&gt;), bold (&lt;b&gt;&lt;/b&gt;),\n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t527' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;italics (&lt;i&gt;&lt;/i&gt;), etc. Your newline characters \n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t528' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;have been converted to &#39;&lt;br&gt;&#39; so they will show \n&quot;</span><span class='strut'>&nbsp;</span></p>
+<p id='t529' class='pln'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='str'>&quot;up right on your Plotly figure!&quot;</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
+<p id='t530' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>s</span><span class='strut'>&nbsp;</span></p>
+<p id='t531' class='pln'>&nbsp; &nbsp; <span class='key'>else</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t532' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>return</span> <span class='nam'>obj</span>&nbsp; <span class='com'># we return the actual reference... but DON&#39;T mutate.</span><span class='strut'>&nbsp;</span></p>
                 
             </td>
         </tr>
diff --git a/plotly/tests/coverage/plotly_utils.html b/plotly/tests/coverage/plotly_utils.html
--- a/plotly/tests/coverage/plotly_utils.html
+++ b/plotly/tests/coverage/plotly_utils.html
@@ -5,7 +5,7 @@
     
     
     <meta http-equiv='X-UA-Compatible' content='IE=emulateIE7' />
-    <title>Coverage for plotly/utils: 40%</title>
+    <title>Coverage for plotly/utils: 42%</title>
     <link rel='stylesheet' href='style.css' type='text/css'>
     
     <script type='text/javascript' src='jquery.min.js'></script>
@@ -21,13 +21,13 @@
 <div id='header'>
     <div class='content'>
         <h1>Coverage for <b>plotly/utils</b> :
-            <span class='pc_cov'>40%</span>
+            <span class='pc_cov'>42%</span>
         </h1>
         <img id='keyboard_icon' src='keybd_closed.png'>
         <h2 class='stats'>
             108 statements &nbsp;
-            <span class='run hide_run shortkey_r button_toggle_run'>43 run</span>
-            <span class='mis shortkey_m button_toggle_mis'>65 missing</span>
+            <span class='run hide_run shortkey_r button_toggle_run'>45 run</span>
+            <span class='mis shortkey_m button_toggle_mis'>63 missing</span>
             <span class='exc shortkey_x button_toggle_exc'>0 excluded</span>
             
         </h2>
@@ -85,8 +85,8 @@ <h2 class='stats'>
 <p id='n22' class='stm run hide_run'><a href='#n22'>22</a></p>
 <p id='n23' class='stm run hide_run'><a href='#n23'>23</a></p>
 <p id='n24' class='stm mis'><a href='#n24'>24</a></p>
-<p id='n25' class='stm mis'><a href='#n25'>25</a></p>
-<p id='n26' class='stm mis'><a href='#n26'>26</a></p>
+<p id='n25' class='stm run hide_run'><a href='#n25'>25</a></p>
+<p id='n26' class='stm run hide_run'><a href='#n26'>26</a></p>
 <p id='n27' class='stm run hide_run'><a href='#n27'>27</a></p>
 <p id='n28' class='stm mis'><a href='#n28'>28</a></p>
 <p id='n29' class='stm mis'><a href='#n29'>29</a></p>
@@ -238,8 +238,8 @@ <h2 class='stats'>
 <p id='t22' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>data</span> <span class='op'>=</span> <span class='nam'>json</span><span class='op'>.</span><span class='nam'>load</span><span class='op'>(</span><span class='nam'>f</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
 <p id='t23' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='key'>not</span> <span class='nam'>isinstance</span><span class='op'>(</span><span class='nam'>data</span><span class='op'>,</span> <span class='nam'>dict</span><span class='op'>)</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
 <p id='t24' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>data</span> <span class='op'>=</span> <span class='op'>{</span><span class='op'>}</span><span class='strut'>&nbsp;</span></p>
-<p id='t25' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
-<p id='t26' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span> <span class='com'># TODO: issue a warning and bubble it up</span><span class='strut'>&nbsp;</span></p>
+<p id='t25' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>except</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
+<p id='t26' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>pass</span> <span class='com'># TODO: issue a warning and bubble it up</span><span class='strut'>&nbsp;</span></p>
 <p id='t27' class='stm run hide_run'>&nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>if</span> <span class='nam'>args</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
 <p id='t28' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='nam'>d</span> <span class='op'>=</span> <span class='nam'>dict</span><span class='op'>(</span><span class='op'>)</span><span class='strut'>&nbsp;</span></p>
 <p id='t29' class='stm mis'>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <span class='key'>for</span> <span class='nam'>key</span> <span class='key'>in</span> <span class='nam'>args</span><span class='op'>:</span><span class='strut'>&nbsp;</span></p>
diff --git a/plotly/tests/coverage/plotly_version.html b/plotly/tests/coverage/plotly_version.html
--- a/plotly/tests/coverage/plotly_version.html
+++ b/plotly/tests/coverage/plotly_version.html
@@ -65,7 +65,7 @@ <h2 class='stats'>
                 
             </td>
             <td class='text' valign='top'>
-<p id='t1' class='stm run hide_run'><span class='nam'>__version__</span> <span class='op'>=</span> <span class='str'>&#39;1.1.4&#39;</span><span class='strut'>&nbsp;</span></p>
+<p id='t1' class='stm run hide_run'><span class='nam'>__version__</span> <span class='op'>=</span> <span class='str'>&#39;1.2.0&#39;</span><span class='strut'>&nbsp;</span></p>
                 
             </td>
         </tr>
diff --git a/plotly/tests/coverage/status.dat b/plotly/tests/coverage/status.dat
--- a/plotly/tests/coverage/status.dat
+++ b/plotly/tests/coverage/status.dat
@@ -110,7 +110,7 @@ I1
 sg19
 I0
 sg20
-I216
+I217
 sg21
 I0
 sg22
@@ -120,7 +120,7 @@ I59
 sg24
 I0
 sbssg25
-S'\x86\xfbM\xf8\xc9\xd1\xb9\xb3S\xd3\x89\x0c\xbaQ\xed\xf2'
+S'\xd9f=\x92sE\xc7b\x8b@\xa8\xb3\xfe\x7f\xd7\xfc'
 p42
 ssS'plotly_tools'
 p43
@@ -144,17 +144,17 @@ I1
 sg19
 I0
 sg20
-I231
+I233
 sg21
 I0
 sg22
 I0
 sg23
-I132
+I51
 sg24
 I0
 sbssg25
-S'\x8dP\x18\x18Y\xd0\xdc\x86j\x1f0G\xd6\xe0\xe8\x13'
+S"\x14\xc4\xb6\x1e\xf2\xa2l\x13\tfG\x97j%'\x0f"
 p50
 ssS'plotly_graph_objs_graph_objs'
 p51
@@ -178,17 +178,17 @@ I1
 sg19
 I0
 sg20
-I608
+I581
 sg21
 I0
 sg22
 I0
 sg23
-I220
+I63
 sg24
 I0
 sbssg25
-S's}\xd6\xe6\xa7%\xaa\x19\xcbc\xb3#\x05\xaaaa'
+S'\xd9\xc9\xc1\x8a\xb7|W\xdf\x9b\xab\xb1\xfb@p\xb3\xeb'
 p58
 ssS'plotly_utils'
 p59
@@ -218,11 +218,11 @@ I0
 sg22
 I0
 sg23
-I65
+I63
 sg24
 I0
 sbssg25
-S'[\x06r\x93\x1dI\x05\x19\x07\\\x8ct5H\xb9\xb9'
+S'\x16\xdd\x19\xcf5\x94\x06\x82\x1f\xd6\x8f\x84\xd9\x0fN\xe2'
 p66
 ssS'plotly_graph_objs_graph_objs_tools'
 p67
@@ -290,7 +290,7 @@ I0
 sg24
 I0
 sbssg25
-S'\x0f@\x8f:\x86&\xd3\x00\x1b\tX:){\xf1_'
+S'~\x01\xf2\xef\xb4kKiMW\xebZ\xc1 \xa6.'
 p82
 ssS'plotly_plotly_plotly'
 p83
@@ -314,17 +314,17 @@ I1
 sg19
 I0
 sg20
-I269
+I270
 sg21
 I0
 sg22
 I0
 sg23
-I155
+I104
 sg24
 I0
 sbssg25
-S'\xc5\x81Y\xdcL\xe7%5\xfb\x98\xce\x9fw\xd6E\xf2'
+S'\xa9"\x99\x0fQ\xae\xdbO\xd4\x06\xcd\xb9S\x0f\xae\xb9'
 p90
 sssS'version'
 p91
diff --git a/plotly/tests/test_matplotlylib/data/__init__.py b/plotly/tests/test_core/__init__.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/data/__init__.py
rename to plotly/tests/test_core/__init__.py
diff --git a/plotly/tests/test_get_figure/__init__.py b/plotly/tests/test_core/test_get_figure/__init__.py
similarity index 100%
rename from plotly/tests/test_get_figure/__init__.py
rename to plotly/tests/test_core/test_get_figure/__init__.py
diff --git a/plotly/tests/test_get_figure/test_get_figure.py b/plotly/tests/test_core/test_get_figure/test_get_figure.py
similarity index 71%
rename from plotly/tests/test_get_figure/test_get_figure.py
rename to plotly/tests/test_core/test_get_figure/test_get_figure.py
--- a/plotly/tests/test_get_figure/test_get_figure.py
+++ b/plotly/tests/test_core/test_get_figure/test_get_figure.py
@@ -8,6 +8,7 @@
 from plotly.graph_objs import graph_objs
 from plotly.plotly import plotly as py
 from plotly import exceptions
+from nose.tools import raises
 
 
 # username for tests: 'plotlyimagetest'
@@ -92,14 +93,66 @@ def is_trivial(obj):
 def test_get_figure():
     un = 'plotlyimagetest'
     ak = '786r5mecv0'
-    run_test = False
     file_id = 2
     py.sign_in(un, ak)
-    print("getting: https://plot.ly/{0}/{1}".format(un, file_id))
+    print("getting: https://plot.ly/~{0}/{1}/".format(un, file_id))
     print("###########################################\n\n")
     fig = py.get_figure('plotlyimagetest', str(file_id))
 
 
+def test_get_figure_with_url():
+    un = 'plotlyimagetest'
+    ak = '786r5mecv0'
+    url = "https://plot.ly/~PlotlyImageTest/2/"
+    py.sign_in(un, ak)
+    print("getting: https://plot.ly/~PlotlyImageTest/2/")
+    print("###########################################\n\n")
+    fig = py.get_figure(url)
+
+
+@raises(exceptions.PlotlyError)
+def test_get_figure_invalid_1():
+    un = 'plotlyimagetest'
+    ak = '786r5mecv0'
+    url = "https://plot.ly/~PlotlyImageTest/a/"
+    py.sign_in(un, ak)
+    print("not getting: https://plot.ly/~PlotlyImageTest/a/")
+    print("###########################################\n\n")
+    fig = py.get_figure(url)
+
+
+@raises(exceptions.PlotlyError)
+def test_get_figure_invalid_2():
+    un = 'plotlyimagetest'
+    ak = '786r5mecv0'
+    url = "https://plot.ly/~PlotlyImageTest/-1/"
+    py.sign_in(un, ak)
+    print("not getting: https://plot.ly/~PlotlyImageTest/-1/")
+    print("###########################################\n\n")
+    fig = py.get_figure(url)
+
+
+@raises(exceptions.PlotlyError)
+def test_get_figure_does_not_exist():
+    un = 'plotlyimagetest'
+    ak = '786r5mecv0'
+    url = "https://plot.ly/~PlotlyImageTest/1000000000/"
+    py.sign_in(un, ak)
+    print("not getting: https://plot.ly/~PlotlyImageTest/1000000000/")
+    print("###########################################\n\n")
+    fig = py.get_figure(url)
+
+
+def test_get_figure_raw():
+    un = 'plotlyimagetest'
+    ak = '786r5mecv0'
+    file_id = 2
+    py.sign_in(un, ak)
+    print("getting: https://plot.ly/~{0}/{1}/".format(un, file_id))
+    print("###########################################\n\n")
+    fig = py.get_figure('plotlyimagetest', str(file_id), raw=True)
+
+
 def test_all():
     un = 'plotlyimagetest'
     ak = '786r5mecv0'
@@ -113,12 +166,12 @@ def test_all():
         while True:
             fig, fig_raw = None, None
             while (file_id in polar_plots) or (file_id in skip):
-                print("    skipping: https://plot.ly/{0}/{1}".format(
+                print("    skipping: https://plot.ly/~{0}/{1}".format(
                     un, file_id))
                 file_id += 1
             print("\n")
             try:
-                print("testing: https://plot.ly/{0}/{1}".format(un, file_id))
+                print("testing: https://plot.ly/~{0}/{1}".format(un, file_id))
                 print("###########################################\n\n")
                 fig = py.get_figure('plotlyimagetest', str(file_id))
                 fig_raw = py.get_figure('plotlyimagetest',
diff --git a/plotly/tests/test_get_requests/__init__.py b/plotly/tests/test_core/test_get_requests/__init__.py
similarity index 100%
rename from plotly/tests/test_get_requests/__init__.py
rename to plotly/tests/test_core/test_get_requests/__init__.py
diff --git a/plotly/tests/test_get_requests/test_get_requests.py b/plotly/tests/test_core/test_get_requests/test_get_requests.py
similarity index 100%
rename from plotly/tests/test_get_requests/test_get_requests.py
rename to plotly/tests/test_core/test_get_requests/test_get_requests.py
diff --git a/plotly/tests/test_graph_objs/__init__.py b/plotly/tests/test_core/test_graph_objs/__init__.py
similarity index 100%
rename from plotly/tests/test_graph_objs/__init__.py
rename to plotly/tests/test_core/test_graph_objs/__init__.py
diff --git a/plotly/tests/test_matplotlylib/nose_tools.py b/plotly/tests/test_core/test_graph_objs/nose_tools.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/nose_tools.py
rename to plotly/tests/test_core/test_graph_objs/nose_tools.py
diff --git a/plotly/tests/test_graph_objs/test_annotations.py b/plotly/tests/test_core/test_graph_objs/test_annotations.py
similarity index 100%
rename from plotly/tests/test_graph_objs/test_annotations.py
rename to plotly/tests/test_core/test_graph_objs/test_annotations.py
diff --git a/plotly/tests/test_graph_objs/test_consistency.py b/plotly/tests/test_core/test_graph_objs/test_consistency.py
similarity index 94%
rename from plotly/tests/test_graph_objs/test_consistency.py
rename to plotly/tests/test_core/test_graph_objs/test_consistency.py
--- a/plotly/tests/test_graph_objs/test_consistency.py
+++ b/plotly/tests/test_core/test_graph_objs/test_consistency.py
@@ -6,7 +6,7 @@
 are properly defined in both graph_objs.py and included in the mapping dicts.
 
 """
-from ... graph_objs import graph_objs
+from plotly.graph_objs import graph_objs
 
 
 def test_info_keys_in_key_to_name():
diff --git a/plotly/tests/test_graph_objs/test_data.py b/plotly/tests/test_core/test_graph_objs/test_data.py
similarity index 100%
rename from plotly/tests/test_graph_objs/test_data.py
rename to plotly/tests/test_core/test_graph_objs/test_data.py
diff --git a/plotly/tests/test_graph_objs/test_error_bars.py b/plotly/tests/test_core/test_graph_objs/test_error_bars.py
similarity index 100%
rename from plotly/tests/test_graph_objs/test_error_bars.py
rename to plotly/tests/test_core/test_graph_objs/test_error_bars.py
diff --git a/plotly/tests/test_core/test_graph_objs/test_get_data.py b/plotly/tests/test_core/test_graph_objs/test_get_data.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_core/test_graph_objs/test_get_data.py
@@ -0,0 +1,129 @@
+from __future__ import absolute_import
+
+from plotly.graph_objs import *
+
+
+def test_get_data():
+    fig = Figure(
+        data=Data([
+            Scatter(
+                x=[52698, 43117],
+                y=[53, 31],
+                mode='markers',
+                name='North America',
+                text=['United States', 'Canada'],
+                marker=Marker(
+                    color='rgb(164, 194, 244)',
+                    size=12,
+                    line=Line(
+                        color='white',
+                        width=0.5
+                    )
+                )
+            ),
+            Scatter(
+                x=[39317, 37236, 35650, 30066, 29570, 27159, 23557, 21046, 18007],
+                y=[33, 20, 13, 19, 27, 19, 49, 44, 38],
+                mode='markers',
+                name='Europe',
+                text=['Germany', 'Britain', 'France', 'Spain', 'Italy', 'Czech Rep.', 'Greece', 'Poland'],
+                marker=Marker(
+                    color='rgb(255, 217, 102)',
+                    size=12,
+                    line=Line(
+                        color='white',
+                        width=0.5
+                    )
+                )
+            ),
+            Scatter(
+                x=[42952, 37037, 33106, 17478, 9813, 5253, 4692, 3899],
+                y=[23, 42, 54, 89, 14, 99, 93, 70],
+                mode='markers',
+                name='Asia/Pacific',
+                text=['Australia', 'Japan', 'South Korea', 'Malaysia', 'China', 'Indonesia', 'Philippines', 'India'],
+                marker=Marker(
+                    color='rgb(234, 153, 153)',
+                    size=12,
+                    line=Line(
+                        color='white',
+                        width=0.5
+                    )
+                )
+            ),
+            Scatter(
+                x=[19097, 18601, 15595, 13546, 12026, 7434, 5419],
+                y=[43, 47, 56, 80, 86, 93, 80],
+                mode='markers',
+                name='Latin America',
+                text=['Chile', 'Argentina', 'Mexico', 'Venezuela', 'Venezuela', 'El Salvador', 'Bolivia'],
+                marker=Marker(
+                    color='rgb(142, 124, 195)',
+                    size=12,
+                    line=Line(
+                        color='white',
+                        width=0.5
+                    )
+                )
+            )
+        ]),
+        layout=Layout(
+            title='Quarter 1 Growth',
+            autosize=False,
+            width=500,
+            height=500,
+            xaxis=XAxis(
+                title='GDP per Capita',
+                showgrid=False,
+                zeroline=False
+            ),
+            yaxis=YAxis(
+                title='Percent',
+                showline=False
+            ),
+            margin=Margin(
+                l=65,
+                r=50,
+                b=65,
+                t=90
+            )
+        )
+    )
+    data = fig.get_data()
+    comp_data = [{'name': 'North America',
+      'text': ['United States', 'Canada'],
+      'x': [52698, 43117],
+      'y': [53, 31]},
+     {'name': 'Europe',
+      'text': ['Germany',
+       'Britain',
+       'France',
+       'Spain',
+       'Italy',
+       'Czech Rep.',
+       'Greece',
+       'Poland'],
+      'x': [39317, 37236, 35650, 30066, 29570, 27159, 23557, 21046, 18007],
+      'y': [33, 20, 13, 19, 27, 19, 49, 44, 38]},
+     {'name': 'Asia/Pacific',
+      'text': ['Australia',
+       'Japan',
+       'South Korea',
+       'Malaysia',
+       'China',
+       'Indonesia',
+       'Philippines',
+       'India'],
+      'x': [42952, 37037, 33106, 17478, 9813, 5253, 4692, 3899],
+      'y': [23, 42, 54, 89, 14, 99, 93, 70]},
+     {'name': 'Latin America',
+      'text': ['Chile',
+       'Argentina',
+       'Mexico',
+       'Venezuela',
+       'Venezuela',
+       'El Salvador',
+       'Bolivia'],
+      'x': [19097, 18601, 15595, 13546, 12026, 7434, 5419],
+      'y': [43, 47, 56, 80, 86, 93, 80]}]
+    assert data == comp_data
diff --git a/plotly/tests/test_core/test_graph_objs/test_get_ordered.py b/plotly/tests/test_core/test_graph_objs/test_get_ordered.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_core/test_graph_objs/test_get_ordered.py
@@ -0,0 +1,98 @@
+from __future__ import absolute_import
+
+try:
+    from collections import OrderedDict
+except ImportError:
+    from ordereddict import OrderedDict
+
+from plotly.graph_objs import *
+
+def test_get_ordered():
+    fig = Figure(
+        data=Data([
+            Scatter(
+                x=[52698, 43117],
+                y=[53, 31],
+                mode='markers',
+                name='North America',
+                text=['United States', 'Canada'],
+                marker=Marker(
+                    color='rgb(164, 194, 244)',
+                    size=12,
+                    line=Line(
+                        color='white',
+                        width=0.5
+                    )
+                )
+            ),
+            Scatter(
+                x=[39317, 37236, 35650, 30066, 29570, 27159, 23557, 21046, 18007],
+                y=[33, 20, 13, 19, 27, 19, 49, 44, 38],
+                mode='markers',
+                name='Europe',
+                text=['Germany', 'Britain', 'France', 'Spain', 'Italy', 'Czech Rep.', 'Greece', 'Poland'],
+                marker=Marker(
+                    color='rgb(255, 217, 102)',
+                    size=12,
+                    line=Line(
+                        color='white',
+                        width=0.5
+                    )
+                )
+            ),
+            Scatter(
+                x=[42952, 37037, 33106, 17478, 9813, 5253, 4692, 3899],
+                y=[23, 42, 54, 89, 14, 99, 93, 70],
+                mode='markers',
+                name='Asia/Pacific',
+                text=['Australia', 'Japan', 'South Korea', 'Malaysia', 'China', 'Indonesia', 'Philippines', 'India'],
+                marker=Marker(
+                    color='rgb(234, 153, 153)',
+                    size=12,
+                    line=Line(
+                        color='white',
+                        width=0.5
+                    )
+                )
+            ),
+            Scatter(
+                x=[19097, 18601, 15595, 13546, 12026, 7434, 5419],
+                y=[43, 47, 56, 80, 86, 93, 80],
+                mode='markers',
+                name='Latin America',
+                text=['Chile', 'Argentina', 'Mexico', 'Venezuela', 'Venezuela', 'El Salvador', 'Bolivia'],
+                marker=Marker(
+                    color='rgb(142, 124, 195)',
+                    size=12,
+                    line=Line(
+                        color='white',
+                        width=0.5
+                    )
+                )
+            )
+        ]),
+        layout=Layout(
+            title='Quarter 1 Growth',
+            autosize=False,
+            width=500,
+            height=500,
+            xaxis=XAxis(
+                title='GDP per Capita',
+                showgrid=False,
+                zeroline=False
+            ),
+            yaxis=YAxis(
+                title='Percent',
+                showline=False
+            ),
+            margin=Margin(
+                l=65,
+                r=50,
+                b=65,
+                t=90
+            )
+        )
+    )
+    ordered_fig = fig.get_ordered()
+    comp_fig = OrderedDict([('data', [OrderedDict([('x', [52698, 43117]), ('y', [53, 31]), ('mode', 'markers'), ('name', 'North America'), ('text', ['United States', 'Canada']), ('marker', OrderedDict([('color', 'rgb(164, 194, 244)'), ('size', 12), ('line', OrderedDict([('color', 'white'), ('width', 0.5)]))])), ('type', 'scatter')]), OrderedDict([('x', [39317, 37236, 35650, 30066, 29570, 27159, 23557, 21046, 18007]), ('y', [33, 20, 13, 19, 27, 19, 49, 44, 38]), ('mode', 'markers'), ('name', 'Europe'), ('text', ['Germany', 'Britain', 'France', 'Spain', 'Italy', 'Czech Rep.', 'Greece', 'Poland']), ('marker', OrderedDict([('color', 'rgb(255, 217, 102)'), ('size', 12), ('line', OrderedDict([('color', 'white'), ('width', 0.5)]))])), ('type', 'scatter')]), OrderedDict([('x', [42952, 37037, 33106, 17478, 9813, 5253, 4692, 3899]), ('y', [23, 42, 54, 89, 14, 99, 93, 70]), ('mode', 'markers'), ('name', 'Asia/Pacific'), ('text', ['Australia', 'Japan', 'South Korea', 'Malaysia', 'China', 'Indonesia', 'Philippines', 'India']), ('marker', OrderedDict([('color', 'rgb(234, 153, 153)'), ('size', 12), ('line', OrderedDict([('color', 'white'), ('width', 0.5)]))])), ('type', 'scatter')]), OrderedDict([('x', [19097, 18601, 15595, 13546, 12026, 7434, 5419]), ('y', [43, 47, 56, 80, 86, 93, 80]), ('mode', 'markers'), ('name', 'Latin America'), ('text', ['Chile', 'Argentina', 'Mexico', 'Venezuela', 'Venezuela', 'El Salvador', 'Bolivia']), ('marker', OrderedDict([('color', 'rgb(142, 124, 195)'), ('size', 12), ('line', OrderedDict([('color', 'white'), ('width', 0.5)]))])), ('type', 'scatter')])]), ('layout', OrderedDict([('title', 'Quarter 1 Growth'), ('autosize', False), ('width', 500), ('height', 500), ('xaxis', OrderedDict([('title', 'GDP per Capita'), ('showgrid', False), ('zeroline', False)])), ('yaxis', OrderedDict([('title', 'Percent'), ('showline', False)])), ('margin', OrderedDict([('l', 65), ('r', 50), ('b', 65), ('t', 90)]))]))])
+    assert ordered_fig == comp_fig
diff --git a/plotly/tests/test_graph_objs/test_plotly_dict.py b/plotly/tests/test_core/test_graph_objs/test_plotly_dict.py
similarity index 100%
rename from plotly/tests/test_graph_objs/test_plotly_dict.py
rename to plotly/tests/test_core/test_graph_objs/test_plotly_dict.py
diff --git a/plotly/tests/test_graph_objs/test_plotly_list.py b/plotly/tests/test_core/test_graph_objs/test_plotly_list.py
similarity index 100%
rename from plotly/tests/test_graph_objs/test_plotly_list.py
rename to plotly/tests/test_core/test_graph_objs/test_plotly_list.py
diff --git a/plotly/tests/test_graph_objs/test_plotly_trace.py b/plotly/tests/test_core/test_graph_objs/test_plotly_trace.py
similarity index 100%
rename from plotly/tests/test_graph_objs/test_plotly_trace.py
rename to plotly/tests/test_core/test_graph_objs/test_plotly_trace.py
diff --git a/plotly/tests/test_graph_objs/test_scatter.py b/plotly/tests/test_core/test_graph_objs/test_scatter.py
similarity index 100%
rename from plotly/tests/test_graph_objs/test_scatter.py
rename to plotly/tests/test_core/test_graph_objs/test_scatter.py
diff --git a/plotly/tests/test_core/test_graph_objs/test_strip_style.py b/plotly/tests/test_core/test_graph_objs/test_strip_style.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_core/test_graph_objs/test_strip_style.py
@@ -0,0 +1,150 @@
+from __future__ import absolute_import
+
+from plotly.graph_objs import *
+from . import nose_tools
+
+
+def test_strip_style():
+    fig = Figure(
+        data=Data([
+            Scatter(
+                x=[52698, 43117],
+                y=[53, 31],
+                mode='markers',
+                name='North America',
+                text=['United States', 'Canada'],
+                marker=Marker(
+                    color='rgb(164, 194, 244)',
+                    size=12,
+                    line=Line(
+                        color='white',
+                        width=0.5
+                    )
+                )
+            ),
+            Scatter(
+                x=[39317, 37236, 35650, 30066, 29570, 27159, 23557, 21046, 18007],
+                y=[33, 20, 13, 19, 27, 19, 49, 44, 38],
+                mode='markers',
+                name='Europe',
+                text=['Germany', 'Britain', 'France', 'Spain', 'Italy', 'Czech Rep.', 'Greece', 'Poland'],
+                marker=Marker(
+                    color='rgb(255, 217, 102)',
+                    size=12,
+                    line=Line(
+                        color='white',
+                        width=0.5
+                    )
+                )
+            ),
+            Scatter(
+                x=[42952, 37037, 33106, 17478, 9813, 5253, 4692, 3899],
+                y=[23, 42, 54, 89, 14, 99, 93, 70],
+                mode='markers',
+                name='Asia/Pacific',
+                text=['Australia', 'Japan', 'South Korea', 'Malaysia', 'China', 'Indonesia', 'Philippines', 'India'],
+                marker=Marker(
+                    color='rgb(234, 153, 153)',
+                    size=12,
+                    line=Line(
+                        color='white',
+                        width=0.5
+                    )
+                )
+            ),
+            Scatter(
+                x=[19097, 18601, 15595, 13546, 12026, 7434, 5419],
+                y=[43, 47, 56, 80, 86, 93, 80],
+                mode='markers',
+                name='Latin America',
+                text=['Chile', 'Argentina', 'Mexico', 'Venezuela', 'Venezuela', 'El Salvador', 'Bolivia'],
+                marker=Marker(
+                    color='rgb(142, 124, 195)',
+                    size=12,
+                    line=Line(
+                        color='white',
+                        width=0.5
+                    )
+                )
+            )
+        ]),
+        layout=Layout(
+            title='Quarter 1 Growth',
+            autosize=False,
+            width=500,
+            height=500,
+            xaxis=XAxis(
+                title='GDP per Capita',
+                showgrid=False,
+                zeroline=False
+            ),
+            yaxis=YAxis(
+                title='Percent',
+                showline=False
+            ),
+            margin=Margin(
+                l=65,
+                r=50,
+                b=65,
+                t=90
+            )
+        )
+    )
+    print(fig)
+    print('\n\n')
+    fig.strip_style()
+    print(fig)
+    print('\n\n')
+    comp_fig = Figure(
+        data=Data([
+            Scatter(
+                x=[52698, 43117],
+                y=[53, 31],
+                name='North America',
+                text=['United States', 'Canada'],
+                marker=Marker(
+                    line=Line()
+                )
+            ),
+            Scatter(
+                x=[39317, 37236, 35650, 30066, 29570, 27159, 23557, 21046, 18007],
+                y=[33, 20, 13, 19, 27, 19, 49, 44, 38],
+                name='Europe',
+                text=['Germany', 'Britain', 'France', 'Spain', 'Italy', 'Czech Rep.', 'Greece', 'Poland'],
+                marker=Marker(
+                    line=Line()
+                )
+            ),
+            Scatter(
+                x=[42952, 37037, 33106, 17478, 9813, 5253, 4692, 3899],
+                y=[23, 42, 54, 89, 14, 99, 93, 70],
+                name='Asia/Pacific',
+                text=['Australia', 'Japan', 'South Korea', 'Malaysia', 'China', 'Indonesia', 'Philippines', 'India'],
+                marker=Marker(
+                    line=Line()
+                )
+            ),
+            Scatter(
+                x=[19097, 18601, 15595, 13546, 12026, 7434, 5419],
+                y=[43, 47, 56, 80, 86, 93, 80],
+                name='Latin America',
+                text=['Chile', 'Argentina', 'Mexico', 'Venezuela', 'Venezuela', 'El Salvador', 'Bolivia'],
+                marker=Marker(
+                    line=Line()
+                )
+            )
+        ]),
+        layout=Layout(
+            title='Quarter 1 Growth',
+            xaxis=XAxis(
+                title='GDP per Capita'
+            ),
+            yaxis=YAxis(
+                title='Percent'
+            ),
+            margin=Margin()
+        )
+    )
+    equivalent, msg = nose_tools.compare_dict(fig, comp_fig)
+    print(msg)
+    assert equivalent
diff --git a/plotly/tests/test_core/test_graph_objs/test_to_string.py b/plotly/tests/test_core/test_graph_objs/test_to_string.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_core/test_graph_objs/test_to_string.py
@@ -0,0 +1,32 @@
+from __future__ import absolute_import
+
+from plotly.graph_objs import *
+
+
+def test_to_string():
+    fig = Figure(
+        data=Data([
+            Scatter(
+                x=[1, 2, 3, 4],
+                y=[10, 15, 13, 17]
+            ),
+            Scatter(
+                x=[1, 2, 3, 4],
+                y=[16, 5, 11, 9]
+            )
+        ]),
+        layout=Layout(
+            autosize=False,
+            width=500,
+            height=500,
+            margin=Margin(
+                l=65,
+                r=50,
+                b=65,
+                t=65
+            )
+        )
+    )
+    fig_string = fig.to_string(pretty=False)
+    comp_string = 'Figure(\n    data=Data([\n        Scatter(\n            x=[1, 2, 3, 4],\n            y=[10, 15, 13, 17]\n        ),\n        Scatter(\n            x=[1, 2, 3, 4],\n            y=[16, 5, 11, 9]\n        )\n    ]),\n    layout=Layout(\n        autosize=False,\n        width=500,\n        height=500,\n        margin=Margin(\n            l=65,\n            r=50,\n            b=65,\n            t=65\n        )\n    )\n)'
+    assert fig_string == comp_string
diff --git a/plotly/tests/test_core/test_graph_objs/test_update.py b/plotly/tests/test_core/test_graph_objs/test_update.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_core/test_graph_objs/test_update.py
@@ -0,0 +1,59 @@
+from __future__ import absolute_import
+
+from plotly.graph_objs import *
+
+
+def test_update_dict():
+    title = 'this'
+    fig = Figure()
+    fig.update(layout=Layout(title=title))
+    assert fig == Figure(layout=Layout(title=title))
+    fig['layout'].update(xaxis=XAxis())
+    assert fig == Figure(layout=Layout(title=title, xaxis=XAxis()))
+
+def test_update_list():
+    trace1 = Scatter(x=[1,2,3], y=[2,1,2])
+    trace2 = Scatter(x=[1,2,3], y=[3,2,1])
+    data = Data([trace1, trace2])
+    update = dict(x=[2,3,4], y=[1,2,3])
+    data.update(update)
+    assert data[0] == Scatter(x=[2,3,4], y=[1,2,3])
+    assert data[1] == Scatter(x=[2,3,4], y=[1,2,3])
+
+
+def test_update_dict_empty():
+    trace1 = Scatter(x=[1,2,3], y=[2,1,2])
+    trace2 = Scatter(x=[1,2,3], y=[3,2,1])
+    data = Data([trace1, trace2])
+    data.update({})
+    print(data.to_string())
+    assert data[0] == Scatter(x=[1,2,3], y=[2,1,2])
+    assert data[1] == Scatter(x=[1,2,3], y=[3,2,1])
+
+
+def test_update_list_empty():
+    trace1 = Scatter(x=[1,2,3], y=[2,1,2])
+    trace2 = Scatter(x=[1,2,3], y=[3,2,1])
+    data = Data([trace1, trace2])
+    data.update([])
+    print(data.to_string())
+    assert data[0] == Scatter(x=[1,2,3], y=[2,1,2])
+    assert data[1] == Scatter(x=[1,2,3], y=[3,2,1])
+
+
+def test_update_list_make_copies_false():
+    trace1 = Scatter(x=[1,2,3], y=[2,1,2])
+    trace2 = Scatter(x=[1,2,3], y=[3,2,1])
+    data = Data([trace1, trace2])
+    update = dict(x=[2,3,4], y=[1,2,3], line=Line())
+    data.update(update, make_copies=False)
+    assert data[0]['line'] is data[1]['line']
+
+
+def test_update_list_make_copies_true():
+    trace1 = Scatter(x=[1,2,3], y=[2,1,2])
+    trace2 = Scatter(x=[1,2,3], y=[3,2,1])
+    data = Data([trace1, trace2])
+    update = dict(x=[2,3,4], y=[1,2,3], line=Line())
+    data.update(update, make_copies=True)
+    assert data[0]['line'] is not data[1]['line']
diff --git a/plotly/tests/test_graph_reference/__init__.py b/plotly/tests/test_core/test_graph_reference/__init__.py
similarity index 100%
rename from plotly/tests/test_graph_reference/__init__.py
rename to plotly/tests/test_core/test_graph_reference/__init__.py
diff --git a/plotly/tests/test_graph_reference/test_key_types.py b/plotly/tests/test_core/test_graph_reference/test_key_types.py
similarity index 100%
rename from plotly/tests/test_graph_reference/test_key_types.py
rename to plotly/tests/test_core/test_graph_reference/test_key_types.py
diff --git a/plotly/tests/test_matplotlylib/__init__.py b/plotly/tests/test_core/test_plotly/__init__.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/__init__.py
rename to plotly/tests/test_core/test_plotly/__init__.py
diff --git a/plotly/tests/test_core/test_plotly/test_credentials.py b/plotly/tests/test_core/test_plotly/test_credentials.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_core/test_plotly/test_credentials.py
@@ -0,0 +1,27 @@
+import plotly.plotly.plotly as py
+import plotly.tools as tls
+
+
+def test_get_credentials():
+    if 'username' in py._credentials:
+        del py._credentials['username']
+    if 'api_key' in py._credentials:
+        del py._credentials['api_key']
+    creds = py.get_credentials()
+    file_creds = tls.get_credentials_file()
+    print(creds)
+    print(file_creds)
+    assert creds == file_creds
+
+
+def test_sign_in():
+    un = 'anyone'
+    ak = 'something'
+    # TODO, add this!
+    # si = ['this', 'and-this']
+    py.sign_in(un, ak)
+    creds = py.get_credentials()
+    assert creds['username'] == un
+    assert creds['api_key'] == ak
+    # TODO, and check it!
+    # assert creds['stream_ids'] == si
\ No newline at end of file
diff --git a/plotly/tests/test_core/test_plotly/test_plot.py b/plotly/tests/test_core/test_plotly/test_plot.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_core/test_plotly/test_plot.py
@@ -0,0 +1,88 @@
+"""
+test_plot:
+==========
+
+A module intended for use with Nose.
+
+"""
+from __future__ import absolute_import
+from nose.tools import raises
+
+from plotly.graph_objs import graph_objs
+from plotly.plotly import plotly as py
+from plotly.exceptions import PlotlyError
+
+
+# username for tests: 'plotlyimagetest'
+# api_key for account: '786r5mecv0'
+
+
+def test_plot_valid():
+    fig = {
+        'data':[
+            {
+                'x':[1,2,3],
+                'y':[2,1,2]
+            }
+        ]
+    }
+    url = py.plot(fig, auto_open=False, filename='plot_valid')
+
+
+@raises(PlotlyError)
+def test_plot_invalid():
+    fig = {
+        'data':[
+            {
+                'x':[1,2,3],
+                'y':[2,1,2],
+                'z':[3,4,1]
+            }
+        ]
+    }
+    url = py.plot(fig, auto_open=False, filename='plot_invalid')
+
+@raises(TypeError)
+def test_plot_invalid_args_1():
+    url = py.plot(x=[1,2,3],
+                  y=[2,1,2],
+                  auto_open=False,
+                  filename='plot_invalid')
+
+@raises(PlotlyError)
+def test_plot_invalid_args_2():
+    url = py.plot([1,2,3], [2,1,2],
+                  auto_open=False,
+                  filename='plot_invalid')
+
+
+def test_bar():
+    pass
+
+
+def test_box():
+    pass
+
+
+def test_contour():
+    pass
+
+
+def test_heatmap():
+    pass
+
+
+def test_histogram():
+    pass
+
+
+def test_histogram2d():
+    pass
+
+
+def test_histogram2dcontour():
+    pass
+
+
+def test_plot_scatter():
+    pass
\ No newline at end of file
diff --git a/plotly/tests/test_stream/__init__.py b/plotly/tests/test_core/test_stream/__init__.py
similarity index 100%
rename from plotly/tests/test_stream/__init__.py
rename to plotly/tests/test_core/test_stream/__init__.py
diff --git a/plotly/tests/test_core/test_stream/test_stream.py b/plotly/tests/test_core/test_stream/test_stream.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_core/test_stream/test_stream.py
@@ -0,0 +1,102 @@
+"""
+test_get_figure:
+=================
+
+A module intended for use with Nose.
+
+"""
+from __future__ import absolute_import
+
+import time
+from nose.tools import raises
+from plotly.graph_objs import *
+import plotly.plotly as py
+from plotly import exceptions
+
+un = 'pythonapi'
+ak = 'ubpiol2cve'
+tk = 'vaia8trjjb'
+
+
+def test_initialize_stream_plot():
+    py.sign_in(un, ak)
+    stream = Stream(token=tk, maxpoints=50)
+    url = py.plot([Scatter(x=[], y=[], mode='markers', stream=stream)],
+                  auto_open=False,
+                  filename='stream-test')
+    assert url == 'https://plot.ly/~PythonAPI/461'
+    time.sleep(.5)
+
+
+def test_stream_single_points():
+    py.sign_in(un, ak)
+    stream = Stream(token=tk, maxpoints=50)
+    res = py.plot([Scatter(x=[], y=[], mode='markers', stream=stream)],
+                  auto_open=False,
+                  filename='stream-test')
+    time.sleep(.5)
+    my_stream = py.Stream(tk)
+    my_stream.open()
+    my_stream.write(Scatter(x=1, y=10))
+    time.sleep(.5)
+    my_stream.close()
+
+
+def test_stream_multiple_points():
+    py.sign_in(un, ak)
+    stream = Stream(token=tk, maxpoints=50)
+    url = py.plot([Scatter(x=[], y=[], mode='markers', stream=stream)],
+                  auto_open=False,
+                  filename='stream-test')
+    time.sleep(.5)
+    my_stream = py.Stream(tk)
+    my_stream.open()
+    my_stream.write(Scatter(x=[1, 2, 3, 4], y=[2, 1, 2, 5]))
+    time.sleep(.5)
+    my_stream.close()
+
+
+def test_stream_layout():
+    py.sign_in(un, ak)
+    stream = Stream(token=tk, maxpoints=50)
+    url = py.plot([Scatter(x=[], y=[], mode='markers', stream=stream)],
+                  auto_open=False,
+                  filename='stream-test')
+    time.sleep(.5)
+    title_0 = "some title i picked first"
+    title_1 = "this other title i picked second"
+    my_stream = py.Stream(tk)
+    my_stream.open()
+    my_stream.write(Scatter(x=1, y=10), layout=Layout(title=title_0))
+    time.sleep(.5)
+    my_stream.close()
+    my_stream.open()
+    my_stream.write(Scatter(x=1, y=10), layout=Layout(title=title_1))
+    my_stream.close()
+
+
+@raises(exceptions.PlotlyError)
+def test_stream_validate_data():
+    py.sign_in(un, ak)
+    my_stream = py.Stream(tk)
+    my_stream.open()
+    my_stream.write(dict(x=1, y=10, z=[1]))  # assumes scatter...
+    my_stream.close()
+
+
+@raises(exceptions.PlotlyError)
+def test_stream_validate_layout():
+    py.sign_in(un, ak)
+    my_stream = py.Stream(tk)
+    my_stream.open()
+    my_stream.write(Scatter(x=1, y=10), layout=Layout(legend=True))
+    my_stream.close()
+
+
+@raises(exceptions.PlotlyError)
+def test_stream_unstreamable():
+    py.sign_in(un, ak)
+    my_stream = py.Stream(tk)
+    my_stream.open()
+    my_stream.write(Scatter(x=1, y=10, name='nope'))
+    my_stream.close()
diff --git a/plotly/tests/test_plotly/__init__.py b/plotly/tests/test_core/test_tools/__init__.py
similarity index 100%
rename from plotly/tests/test_plotly/__init__.py
rename to plotly/tests/test_core/test_tools/__init__.py
diff --git a/plotly/tests/test_core/test_tools/test_file_tools.py b/plotly/tests/test_core/test_tools/test_file_tools.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_core/test_tools/test_file_tools.py
@@ -0,0 +1,31 @@
+import plotly.tools as tls
+
+
+def test_reset_config_file():
+    tls.reset_config_file()
+    config = tls.get_config_file()
+    assert config['plotly_domain'] == 'https://plot.ly'
+    assert config['plotly_streaming_domain'] == 'stream.plot.ly'
+
+
+def test_set_config_file():
+    pd, ps = 'this', 'thing'
+    tls.set_config_file(plotly_domain=pd, plotly_streaming_domain=ps)
+    config = tls.get_config_file()
+    assert config['plotly_domain'] == pd
+    assert config['plotly_streaming_domain'] == ps
+    tls.reset_config_file()  # else every would hate me :)
+
+
+def test_credentials_tools():
+    original_creds = tls.get_credentials_file()
+    expected = ['username', 'stream_ids', 'api_key']
+    assert all(x in original_creds for x in expected)
+    # now, if that worked, we can try this!
+    tls.reset_credentials_file()
+    reset_creds = tls.get_credentials_file()
+    tls.set_credentials_file(**original_creds)
+    assert all(x in reset_creds for x in expected)
+    creds = tls.get_credentials_file()
+    assert all(x in creds for x in expected)
+    assert original_creds == creds
diff --git a/plotly/tests/test_core/test_tools/test_get_embed.py b/plotly/tests/test_core/test_tools/test_get_embed.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_core/test_tools/test_get_embed.py
@@ -0,0 +1,14 @@
+import plotly.tools as tls
+from nose.tools import raises
+from plotly.exceptions import PlotlyError
+
+
+def test_get_valid_embed():
+    url = 'https://plot.ly/~PlotBot/82/'
+    embed = tls.get_embed(url)
+
+
+@raises(PlotlyError)
+def test_get_invalid_embed():
+    url = 'https://plot.ly/~PlotBot/a/'
+    embed = tls.get_embed(url)
diff --git a/plotly/tests/test_core/test_tools/test_get_subplots.py b/plotly/tests/test_core/test_tools/test_get_subplots.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_core/test_tools/test_get_subplots.py
@@ -0,0 +1,358 @@
+import plotly
+from plotly.graph_objs import *
+import plotly.tools as tls
+
+def test_get_single_plot():
+    expected = Figure(
+        data=Data(),
+        layout=Layout(
+            xaxis1=XAxis(
+                domain=[0.0, 1.0],
+                anchor='y1'
+            ),
+            yaxis1=YAxis(
+                domain=[0.0, 1.0],
+                anchor='x1'
+            )
+        )
+    )
+    assert tls.get_subplots() == expected
+
+def test_two_row():
+    expected = Figure(
+        data=Data(),
+        layout=Layout(
+            xaxis1=XAxis(
+                domain=[0.0, 1.0],
+                anchor='y1'
+            ),
+            xaxis2=XAxis(
+                domain=[0.0, 1.0],
+                anchor='y2'
+            ),
+            yaxis1=YAxis(
+                domain=[0.0, 0.425],
+                anchor='x1'
+            ),
+            yaxis2=YAxis(
+                domain=[0.575, 1.0],
+                anchor='x2'
+            )
+        )
+    )
+    assert tls.get_subplots(2) == expected
+
+
+def test_two_column():
+    expected = Figure(
+        data=Data(),
+        layout=Layout(
+            xaxis1=XAxis(
+                domain=[0.0, 0.45],
+                anchor='y1'
+            ),
+            xaxis2=XAxis(
+                domain=[0.55, 1.0],
+                anchor='y2'
+            ),
+            yaxis1=YAxis(
+                domain=[0.0, 1.0],
+                anchor='x1'
+            ),
+            yaxis2=YAxis(
+                domain=[0.0, 1.0],
+                anchor='x2'
+            )
+        )
+    )
+
+    assert tls.get_subplots(1, 2) == expected
+
+def test_a_lot():
+    expected = Figure(
+        data=Data(),
+        layout=Layout(
+            xaxis1=XAxis(
+                domain=[0.0, 0.05714285714285713],
+                anchor='y1'
+            ),
+            xaxis10=XAxis(
+                domain=[0.3142857142857143, 0.3714285714285714],
+                anchor='y10'
+            ),
+            xaxis11=XAxis(
+                domain=[0.4714285714285714, 0.5285714285714286],
+                anchor='y11'
+            ),
+            xaxis12=XAxis(
+                domain=[0.6285714285714286, 0.6857142857142857],
+                anchor='y12'
+            ),
+            xaxis13=XAxis(
+                domain=[0.7857142857142857, 0.8428571428571429],
+                anchor='y13'
+            ),
+            xaxis14=XAxis(
+                domain=[0.9428571428571428, 1.0],
+                anchor='y14'
+            ),
+            xaxis15=XAxis(
+                domain=[0.0, 0.05714285714285713],
+                anchor='y15'
+            ),
+            xaxis16=XAxis(
+                domain=[0.15714285714285714, 0.21428571428571427],
+                anchor='y16'
+            ),
+            xaxis17=XAxis(
+                domain=[0.3142857142857143, 0.3714285714285714],
+                anchor='y17'
+            ),
+            xaxis18=XAxis(
+                domain=[0.4714285714285714, 0.5285714285714286],
+                anchor='y18'
+            ),
+            xaxis19=XAxis(
+                domain=[0.6285714285714286, 0.6857142857142857],
+                anchor='y19'
+            ),
+            xaxis2=XAxis(
+                domain=[0.15714285714285714, 0.21428571428571427],
+                anchor='y2'
+            ),
+            xaxis20=XAxis(
+                domain=[0.7857142857142857, 0.8428571428571429],
+                anchor='y20'
+            ),
+            xaxis21=XAxis(
+                domain=[0.9428571428571428, 1.0],
+                anchor='y21'
+            ),
+            xaxis22=XAxis(
+                domain=[0.0, 0.05714285714285713],
+                anchor='y22'
+            ),
+            xaxis23=XAxis(
+                domain=[0.15714285714285714, 0.21428571428571427],
+                anchor='y23'
+            ),
+            xaxis24=XAxis(
+                domain=[0.3142857142857143, 0.3714285714285714],
+                anchor='y24'
+            ),
+            xaxis25=XAxis(
+                domain=[0.4714285714285714, 0.5285714285714286],
+                anchor='y25'
+            ),
+            xaxis26=XAxis(
+                domain=[0.6285714285714286, 0.6857142857142857],
+                anchor='y26'
+            ),
+            xaxis27=XAxis(
+                domain=[0.7857142857142857, 0.8428571428571429],
+                anchor='y27'
+            ),
+            xaxis28=XAxis(
+                domain=[0.9428571428571428, 1.0],
+                anchor='y28'
+            ),
+            xaxis3=XAxis(
+                domain=[0.3142857142857143, 0.3714285714285714],
+                anchor='y3'
+            ),
+            xaxis4=XAxis(
+                domain=[0.4714285714285714, 0.5285714285714286],
+                anchor='y4'
+            ),
+            xaxis5=XAxis(
+                domain=[0.6285714285714286, 0.6857142857142857],
+                anchor='y5'
+            ),
+            xaxis6=XAxis(
+                domain=[0.7857142857142857, 0.8428571428571429],
+                anchor='y6'
+            ),
+            xaxis7=XAxis(
+                domain=[0.9428571428571428, 1.0],
+                anchor='y7'
+            ),
+            xaxis8=XAxis(
+                domain=[0.0, 0.05714285714285713],
+                anchor='y8'
+            ),
+            xaxis9=XAxis(
+                domain=[0.15714285714285714, 0.21428571428571427],
+                anchor='y9'
+            ),
+            yaxis1=YAxis(
+                domain=[0.0, 0.1375],
+                anchor='x1'
+            ),
+            yaxis10=YAxis(
+                domain=[0.2875, 0.425],
+                anchor='x10'
+            ),
+            yaxis11=YAxis(
+                domain=[0.2875, 0.425],
+                anchor='x11'
+            ),
+            yaxis12=YAxis(
+                domain=[0.2875, 0.425],
+                anchor='x12'
+            ),
+            yaxis13=YAxis(
+                domain=[0.2875, 0.425],
+                anchor='x13'
+            ),
+            yaxis14=YAxis(
+                domain=[0.2875, 0.425],
+                anchor='x14'
+            ),
+            yaxis15=YAxis(
+                domain=[0.575, 0.7124999999999999],
+                anchor='x15'
+            ),
+            yaxis16=YAxis(
+                domain=[0.575, 0.7124999999999999],
+                anchor='x16'
+            ),
+            yaxis17=YAxis(
+                domain=[0.575, 0.7124999999999999],
+                anchor='x17'
+            ),
+            yaxis18=YAxis(
+                domain=[0.575, 0.7124999999999999],
+                anchor='x18'
+            ),
+            yaxis19=YAxis(
+                domain=[0.575, 0.7124999999999999],
+                anchor='x19'
+            ),
+            yaxis2=YAxis(
+                domain=[0.0, 0.1375],
+                anchor='x2'
+            ),
+            yaxis20=YAxis(
+                domain=[0.575, 0.7124999999999999],
+                anchor='x20'
+            ),
+            yaxis21=YAxis(
+                domain=[0.575, 0.7124999999999999],
+                anchor='x21'
+            ),
+            yaxis22=YAxis(
+                domain=[0.8624999999999999, 1.0],
+                anchor='x22'
+            ),
+            yaxis23=YAxis(
+                domain=[0.8624999999999999, 1.0],
+                anchor='x23'
+            ),
+            yaxis24=YAxis(
+                domain=[0.8624999999999999, 1.0],
+                anchor='x24'
+            ),
+            yaxis25=YAxis(
+                domain=[0.8624999999999999, 1.0],
+                anchor='x25'
+            ),
+            yaxis26=YAxis(
+                domain=[0.8624999999999999, 1.0],
+                anchor='x26'
+            ),
+            yaxis27=YAxis(
+                domain=[0.8624999999999999, 1.0],
+                anchor='x27'
+            ),
+            yaxis28=YAxis(
+                domain=[0.8624999999999999, 1.0],
+                anchor='x28'
+            ),
+            yaxis3=YAxis(
+                domain=[0.0, 0.1375],
+                anchor='x3'
+            ),
+            yaxis4=YAxis(
+                domain=[0.0, 0.1375],
+                anchor='x4'
+            ),
+            yaxis5=YAxis(
+                domain=[0.0, 0.1375],
+                anchor='x5'
+            ),
+            yaxis6=YAxis(
+                domain=[0.0, 0.1375],
+                anchor='x6'
+            ),
+            yaxis7=YAxis(
+                domain=[0.0, 0.1375],
+                anchor='x7'
+            ),
+            yaxis8=YAxis(
+                domain=[0.2875, 0.425],
+                anchor='x8'
+            ),
+            yaxis9=YAxis(
+                domain=[0.2875, 0.425],
+                anchor='x9'
+            )
+        )
+    )
+    assert tls.get_subplots(4, 7) == expected
+
+def test_spacing():
+    expected = Figure(
+        data=Data(),
+        layout=Layout(
+            xaxis1=XAxis(
+                domain=[0.0, 0.3],
+                anchor='y1'
+            ),
+            xaxis2=XAxis(
+                domain=[0.35, 0.6499999999999999],
+                anchor='y2'
+            ),
+            xaxis3=XAxis(
+                domain=[0.7, 1.0],
+                anchor='y3'
+            ),
+            xaxis4=XAxis(
+                domain=[0.0, 0.3],
+                anchor='y4'
+            ),
+            xaxis5=XAxis(
+                domain=[0.35, 0.6499999999999999],
+                anchor='y5'
+            ),
+            xaxis6=XAxis(
+                domain=[0.7, 1.0],
+                anchor='y6'
+            ),
+            yaxis1=YAxis(
+                domain=[0.0, 0.45],
+                anchor='x1'
+            ),
+            yaxis2=YAxis(
+                domain=[0.0, 0.45],
+                anchor='x2'
+            ),
+            yaxis3=YAxis(
+                domain=[0.0, 0.45],
+                anchor='x3'
+            ),
+            yaxis4=YAxis(
+                domain=[0.55, 1.0],
+                anchor='x4'
+            ),
+            yaxis5=YAxis(
+                domain=[0.55, 1.0],
+                anchor='x5'
+            ),
+            yaxis6=YAxis(
+                domain=[0.55, 1.0],
+                anchor='x6'
+            )
+        )
+    )
+
+    assert expected == tls.get_subplots(2, 3, .05, .1)
diff --git a/plotly/tests/test_core/test_tools/test_validate.py b/plotly/tests/test_core/test_tools/test_validate.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_core/test_tools/test_validate.py
@@ -0,0 +1,34 @@
+from __future__ import absolute_import
+
+import plotly.tools as tls
+from nose.tools import raises
+from plotly.exceptions import PlotlyError
+
+
+def test_validate_valid_fig():
+    fig = {
+        'layout':{
+            'title':'something'
+        },
+        'data':[
+            {
+                'x':[1,2,3],
+                'y':[2,1,2]
+            }
+        ]
+    }
+    tls.validate(fig, 'Figure')
+
+
+@raises(PlotlyError)
+def test_validate_invalid_fig():
+    fig = {
+        'layout':{
+            'title':'something'
+        },
+        'data':{
+            'x':[1,2,3],
+            'y':[2,1,2]
+        }
+    }
+    tls.validate(fig, 'Figure')
diff --git a/plotly/tests/test_plotly/data/bar.py b/plotly/tests/test_optional/__init__.py
similarity index 100%
rename from plotly/tests/test_plotly/data/bar.py
rename to plotly/tests/test_optional/__init__.py
diff --git a/plotly/tests/test_tools/__init__.py b/plotly/tests/test_optional/test_matplotlylib/__init__.py
similarity index 100%
rename from plotly/tests/test_tools/__init__.py
rename to plotly/tests/test_optional/test_matplotlylib/__init__.py
diff --git a/plotly/tests/test_optional/test_matplotlylib/data/__init__.py b/plotly/tests/test_optional/test_matplotlylib/data/__init__.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_optional/test_matplotlylib/data/__init__.py
@@ -0,0 +1 @@
+
diff --git a/plotly/tests/test_matplotlylib/data/annotations.py b/plotly/tests/test_optional/test_matplotlylib/data/annotations.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/data/annotations.py
rename to plotly/tests/test_optional/test_matplotlylib/data/annotations.py
diff --git a/plotly/tests/test_matplotlylib/data/axis_scales.py b/plotly/tests/test_optional/test_matplotlylib/data/axis_scales.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/data/axis_scales.py
rename to plotly/tests/test_optional/test_matplotlylib/data/axis_scales.py
diff --git a/plotly/tests/test_matplotlylib/data/bars.py b/plotly/tests/test_optional/test_matplotlylib/data/bars.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/data/bars.py
rename to plotly/tests/test_optional/test_matplotlylib/data/bars.py
diff --git a/plotly/tests/test_matplotlylib/data/data.py b/plotly/tests/test_optional/test_matplotlylib/data/data.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/data/data.py
rename to plotly/tests/test_optional/test_matplotlylib/data/data.py
diff --git a/plotly/tests/test_matplotlylib/data/lines.py b/plotly/tests/test_optional/test_matplotlylib/data/lines.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/data/lines.py
rename to plotly/tests/test_optional/test_matplotlylib/data/lines.py
diff --git a/plotly/tests/test_matplotlylib/data/scatter.py b/plotly/tests/test_optional/test_matplotlylib/data/scatter.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/data/scatter.py
rename to plotly/tests/test_optional/test_matplotlylib/data/scatter.py
diff --git a/plotly/tests/test_matplotlylib/data/subplots.py b/plotly/tests/test_optional/test_matplotlylib/data/subplots.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/data/subplots.py
rename to plotly/tests/test_optional/test_matplotlylib/data/subplots.py
diff --git a/plotly/tests/test_optional/test_matplotlylib/nose_tools.py b/plotly/tests/test_optional/test_matplotlylib/nose_tools.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_optional/test_matplotlylib/nose_tools.py
@@ -0,0 +1,63 @@
+from __future__ import absolute_import
+
+import matplotlib
+# Force matplotlib to not use any Xwindows backend.
+matplotlib.use('Agg')
+from plotly.matplotlylib import Exporter, PlotlyRenderer
+from numbers import Number as Num
+
+
+def compare_dict(dict1, dict2, equivalent=True, msg='', tol=10e-8):
+    for key in dict1:
+        if key not in dict2:
+            return False, "{} should be {}".format(list(dict1.keys()), list(dict2.keys()))
+    for key in dict1:
+        if isinstance(dict1[key], dict):
+            equivalent, msg = compare_dict(dict1[key],
+                                           dict2[key],
+                                           tol=tol)
+        elif isinstance(dict1[key], Num) and isinstance(dict2[key], Num):
+            if not comp_nums(dict1[key], dict2[key], tol):
+                return False, "['{}'] = {} should be {}".format(key,
+                                                                dict1[key],
+                                                                dict2[key])
+        elif is_num_list(dict1[key]) and is_num_list(dict2[key]):
+            if not comp_num_list(dict1[key], dict2[key], tol):
+                return False, "['{}'] = {} should be {}".format(key,
+                                                                dict1[key],
+                                                                dict2[key])
+        elif not (dict1[key] == dict2[key]):
+                return False, "['{}'] = {} should be {}".format(key,
+                                                                dict1[key],
+                                                                dict2[key])
+        if not equivalent:
+            return False, "['{}']".format(key) + msg
+    return equivalent, msg
+
+
+def comp_nums(num1, num2, tol=10e-8):
+    return abs(num1-num2) < tol
+
+
+def comp_num_list(list1, list2, tol=10e-8):
+    for item1, item2 in zip(list1, list2):
+        if not comp_nums(item1, item2, tol):
+            return False
+    return True
+
+
+def is_num_list(item):
+    try:
+        for thing in item:
+            if not isinstance(thing, Num):
+                raise TypeError
+    except TypeError:
+        return False
+    return True
+
+
+def run_fig(fig):
+    renderer = PlotlyRenderer()
+    exporter = Exporter(renderer)
+    exporter.run(fig)
+    return renderer
diff --git a/plotly/tests/test_matplotlylib/test_annotations.py b/plotly/tests/test_optional/test_matplotlylib/test_annotations.py
similarity index 93%
rename from plotly/tests/test_matplotlylib/test_annotations.py
rename to plotly/tests/test_optional/test_matplotlylib/test_annotations.py
--- a/plotly/tests/test_matplotlylib/test_annotations.py
+++ b/plotly/tests/test_optional/test_matplotlylib/test_annotations.py
@@ -5,8 +5,8 @@
 matplotlib.use('Agg')
 import matplotlib.pyplot as plt
 
-from . nose_tools import compare_dict, run_fig
-from . data.annotations import *
+from .nose_tools import compare_dict, run_fig
+from .data.annotations import *
 
 
 def test_annotations():
diff --git a/plotly/tests/test_matplotlylib/test_axis_scales.py b/plotly/tests/test_optional/test_matplotlylib/test_axis_scales.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/test_axis_scales.py
rename to plotly/tests/test_optional/test_matplotlylib/test_axis_scales.py
diff --git a/plotly/tests/test_matplotlylib/test_bars.py b/plotly/tests/test_optional/test_matplotlylib/test_bars.py
similarity index 96%
rename from plotly/tests/test_matplotlylib/test_bars.py
rename to plotly/tests/test_optional/test_matplotlylib/test_bars.py
--- a/plotly/tests/test_matplotlylib/test_bars.py
+++ b/plotly/tests/test_optional/test_matplotlylib/test_bars.py
@@ -3,7 +3,7 @@
 matplotlib.use('Agg')
 import matplotlib.pyplot as plt
 
-from . nose_tools import compare_dict, run_fig
+from .nose_tools import compare_dict, run_fig
 from .data.bars import *
 
 
diff --git a/plotly/tests/test_matplotlylib/test_data.py b/plotly/tests/test_optional/test_matplotlylib/test_data.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/test_data.py
rename to plotly/tests/test_optional/test_matplotlylib/test_data.py
diff --git a/plotly/tests/test_matplotlylib/test_lines.py b/plotly/tests/test_optional/test_matplotlylib/test_lines.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/test_lines.py
rename to plotly/tests/test_optional/test_matplotlylib/test_lines.py
diff --git a/plotly/tests/test_matplotlylib/test_scatter.py b/plotly/tests/test_optional/test_matplotlylib/test_scatter.py
similarity index 100%
rename from plotly/tests/test_matplotlylib/test_scatter.py
rename to plotly/tests/test_optional/test_matplotlylib/test_scatter.py
diff --git a/plotly/tests/test_matplotlylib/test_subplots.py b/plotly/tests/test_optional/test_matplotlylib/test_subplots.py
similarity index 96%
rename from plotly/tests/test_matplotlylib/test_subplots.py
rename to plotly/tests/test_optional/test_matplotlylib/test_subplots.py
--- a/plotly/tests/test_matplotlylib/test_subplots.py
+++ b/plotly/tests/test_optional/test_matplotlylib/test_subplots.py
@@ -5,7 +5,7 @@
 from matplotlib.gridspec import GridSpec
 
 from .nose_tools import compare_dict, run_fig
-from . data.subplots import *
+from .data.subplots import *
 
 
 def test_blank_subplots():
diff --git a/plotly/tests/test_optional/test_plotly/__init__.py b/plotly/tests/test_optional/test_plotly/__init__.py
new file mode 100644
--- /dev/null
+++ b/plotly/tests/test_optional/test_plotly/__init__.py
@@ -0,0 +1,7 @@
+def setup_package():
+    import warnings
+    warnings.filterwarnings('ignore')
+
+
+def teardown_package():
+    pass
\ No newline at end of file
diff --git a/plotly/tests/test_plotly/test_plot_mpl.py b/plotly/tests/test_optional/test_plotly/test_plot_mpl.py
similarity index 100%
rename from plotly/tests/test_plotly/test_plot_mpl.py
rename to plotly/tests/test_optional/test_plotly/test_plot_mpl.py
diff --git a/plotly/tests/test_plotly/data/__init__.py b/plotly/tests/test_plotly/data/__init__.py
deleted file mode 100644
diff --git a/plotly/tests/test_plotly/test_plot.py b/plotly/tests/test_plotly/test_plot.py
deleted file mode 100644
--- a/plotly/tests/test_plotly/test_plot.py
+++ /dev/null
@@ -1,50 +0,0 @@
-"""
-test_plot:
-==========
-
-A module intended for use with Nose.
-
-"""
-from __future__ import absolute_import
-
-from plotly.graph_objs import graph_objs
-from plotly.plotly import plotly as py
-from plotly import exceptions
-
-
-# username for tests: 'plotlyimagetest'
-# api_key for account: '786r5mecv0'
-
-__all__ = ["Bar", "Box", "Contour", "Heatmap",
-           "Histogram", "Histogram2d", "Histogram2dContour", "Scatter"]
-
-def test_bar():
-    pass
-
-
-def test_box():
-    pass
-
-
-def test_contour():
-    pass
-
-
-def test_heatmap():
-    pass
-
-
-def test_histogram():
-    pass
-
-
-def test_histogram2d():
-    pass
-
-
-def test_histogram2dcontour():
-    pass
-
-
-def test_plot_scatter():
-    pass
\ No newline at end of file
diff --git a/plotly/tests/test_stream/test_stream.py b/plotly/tests/test_stream/test_stream.py
deleted file mode 100644
--- a/plotly/tests/test_stream/test_stream.py
+++ /dev/null
@@ -1,118 +0,0 @@
-"""
-test_get_figure:
-=================
-
-A module intended for use with Nose.
-
-"""
-from __future__ import absolute_import
-
-import time
-from nose.tools import raises
-from plotly.graph_objs import *
-from plotly.plotly import plotly as py
-from plotly import exceptions
-
-un = 'pythonapi'
-ak = 'ubpiol2cve'
-tk = 'vaia8trjjb'
-fi = 461
-py.sign_in(un, ak)
-
-run_tests = False
-
-
-def test_initialize_stream_plot():
-    if run_tests:
-        stream = Stream(token=tk, maxpoints=50)
-        res = py.plot([Scatter(x=[], y=[], mode='markers', stream=stream)],
-                      auto_open=False,
-                      filename='stream-test')
-        assert res == 'https://plot.ly/~PythonAPI/461'
-        time.sleep(5)
-
-
-def test_stream_single_points():
-    if run_tests:
-        stream = Stream(token=tk, maxpoints=50)
-        res = py.plot([Scatter(x=[], y=[], mode='markers', stream=stream)],
-                      auto_open=False,
-                      filename='stream-test')
-        time.sleep(5)
-        my_stream = py.Stream(tk)
-        my_stream.open()
-        my_stream.write(Scatter(x=1, y=10))
-        time.sleep(1)
-        my_stream.close()
-        fig = py.get_figure(un, fi)
-        print(fig.to_string())
-        assert fig['data'][0]['x'] == 1
-        assert fig['data'][0]['y'] == 10
-
-
-def test_stream_multiple_points():
-    if run_tests:
-        stream = Stream(token=tk, maxpoints=50)
-        res = py.plot([Scatter(x=[], y=[], mode='markers', stream=stream)],
-                      auto_open=False,
-                      filename='stream-test')
-        time.sleep(5)
-        my_stream = py.Stream(tk)
-        my_stream.open()
-        my_stream.write(Scatter(x=[1, 2, 3, 4], y=[2, 1, 2, 5]))
-        time.sleep(1)
-        my_stream.close()
-        fig = py.get_figure(un, fi)
-        print(fig.to_string())
-        assert fig['data'][0]['x'] == [1, 2, 3, 4]
-        assert fig['data'][0]['y'] == [2, 1, 2, 5]
-
-
-def test_stream_layout():
-    if run_tests:
-        stream = Stream(token=tk, maxpoints=50)
-        res = py.plot([Scatter(x=[], y=[], mode='markers', stream=stream)],
-                      auto_open=False,
-                      filename='stream-test')
-        time.sleep(5)
-        title_0 = "some title i picked first"
-        title_1 = "this other title i picked second"
-        my_stream = py.Stream(tk)
-        my_stream.open()
-        my_stream.write(Scatter(x=1, y=10), layout=Layout(title=title_0))
-        time.sleep(1)
-        my_stream.close()
-        fig = py.get_figure(un, fi)
-        print(fig.to_string())
-        assert fig['layout']['title'] == title_0
-        my_stream.open()
-        my_stream.write(Scatter(x=1, y=10), layout=Layout(title=title_1))
-        time.sleep(1)
-        my_stream.close()
-        fig = py.get_figure(un, fi)
-        print(fig.to_string())
-        assert fig['layout']['title'] == title_1
-
-
-@raises(exceptions.PlotlyError)
-def test_stream_validate_data():
-    if run_tests:
-        my_stream = py.Stream(tk)
-        my_stream.open()
-        my_stream.write(dict(x=1, y=10, z=[1]))  # assumes scatter...
-        time.sleep(1)
-        my_stream.close()
-    else:
-        raise exceptions.PlotlyError()
-
-
-@raises(exceptions.PlotlyError)
-def test_stream_validate_layout():
-    if run_tests:
-        my_stream = py.Stream(tk)
-        my_stream.open()
-        my_stream.write(Scatter(x=1, y=10), layout=Layout(legend=True))
-        time.sleep(1)
-        my_stream.close()
-    else:
-        raise exceptions.PlotlyError()
\ No newline at end of file
diff --git a/plotly/tests/test_tools/test_validate.py b/plotly/tests/test_tools/test_validate.py
deleted file mode 100644
--- a/plotly/tests/test_tools/test_validate.py
+++ /dev/null
@@ -1,6 +0,0 @@
-from __future__ import absolute_import
-
-from plotly import graph_objs
-
-
-