pytecplot 1.5.2__py3-none-any.whl

tecplot/extension/ipython.py

@@ -0,0 +1,68 @@
+"""
+Integration with Jupyter IPython Notebooks
+------------------------------------------
+
+The environment variables needed to run and start |PyTecplot| have to be set
+when the Jupyter server is started for them to take effect for each notebook
+created. This includes ``PATH`` for Windows, ``LD_LIBRARY_PATH`` for Linux
+and ``DYLD_LIBRARY_PATH`` for Mac OS X (see `Installation` for details).
+Once set, the notebook server can usually be started with the command::
+
+    jupyter notebook
+
+Depending on your configuration, this may bring up your default web browser
+showing the jupyter notebook interface.
+"""
+
+import importlib
+import io
+import logging
+import os
+import tempfile
+import warnings
+
+from .. import layout, export
+
+log = logging.getLogger(__name__)
+
+def show(frame=None, width=600):
+    """Display a `Frame <layout.Frame>` as an image inline in a notebook.
+
+    Parameters:
+        frame (`Frame <layout.Frame>`, optional): The `Frame <layout.Frame>` to display. The active `Frame <layout.Frame>`
+            will be used if `None`. (default: `None`)
+        width (`int`, optional): Width of the image in pixels.
+            (default: 600)
+
+    Example::
+
+        >>> tecplot.load_layout('mylayout.lay')
+        >>> tecplot.extension.ipython.show()
+
+    This should put the resulting image just below the current cell in the
+    notebook.
+    """
+    with warnings.catch_warnings():
+        warnings.filterwarnings("ignore", category=DeprecationWarning)
+        from PIL import Image
+        import IPython
+
+    frame = frame or layout.active_frame()
+    f = tempfile.NamedTemporaryFile(prefix=frame.name,
+                                    suffix='.png',
+                                    delete=False)
+    try:
+        with frame.activated():
+            frame.move_to_top()
+            f.close()
+            export.save_png(f.name, width)
+        with open(f.name, 'rb') as fimg:
+            im = Image.open(fimg)
+            b = io.BytesIO()
+            im.save(b, format='png')
+        IPython.display.display(IPython.display.Image(data=b.getvalue()))
+    finally:
+        try:
+            os.remove(f.name)
+        except OSError:
+            log.warning('could not remove temporary file: {}'.format(f.name))

tecplot/layout/__init__.py

@@ -0,0 +1,20 @@
+"""Pages, frames and other layout-related operations.
+
+The "layout" consists of a stack of `Pages <tecplot.layout.Page>` identified by index or
+`name <Page.name>`. Each `Page <tecplot.layout.Page>` consists of a single "workspace" which holds
+a collection of `Frames <tecplot.layout.Frame>` that are laid out in relation to an area
+called the `Paper`.
+
+The |Tecplot Engine| is guaranteed to have at least one `Page <tecplot.layout.Page>` which is
+holding onto at least one `Frame <tecplot.layout.Frame>`. It also has the concept of an active
+`Frame <tecplot.layout.Frame>` and by extension, an active `Page <tecplot.layout.Page>`. Most, if not all operations
+that require a handle to a `Frame <tecplot.layout.Frame>` will use the active `Frame <tecplot.layout.Frame>` by default.
+This includes any function that operates on objects held by a `Frame <tecplot.layout.Frame>`
+such as a `Cartesian3DFieldPlot` or `Dataset <tecplot.data.Dataset>`.
+"""
+
+from .frame import Frame
+from .layout import (active_frame, active_page, add_page, aux_data, delete_page,
+                     frames, next_page, num_pages, page, pages, next_page,
+                     new_layout, load_layout, save_layout)
+from .page import Page, Paper