pytecplot 1.2.1__zip → 1.3.1__zip

{pytecplot-1.2.1 → pytecplot-1.3.1r110473}/examples/26_multiprocess_job_pool.py

@@ -22,6 +22,8 @@ def work(solution_time):
 if __name__ == '__main__':
     if sys.version_info < (3, 5):
         raise Exception('This example requires Python version 3.5+')
+    if tp.session.connected():
+        raise Exception('This example must be run in batch mode')
 
     # !!! IMPORTANT !!!
     # On Linux systems, Python's multiprocessing start method

{pytecplot-1.2.1 → pytecplot-1.3.1r110473}/examples/27_multiprocess_job_pool_advanced.py

@@ -64,6 +64,8 @@ def plot_line(x, y, xlabel='x', ylabel='y'):
 if __name__ == '__main__':
     if sys.version_info < (3, 5):
         raise Exception('This example requires Python version 3.5+')
+    if tp.session.connected():
+        raise Exception('This example must be run in batch mode')
 
     # Get the datafile, stylesheet and job parameters (solution times)
     examples_dir = tp.session.tecplot_examples_directory()

{pytecplot-1.2.1 → pytecplot-1.3.1r110473/pytecplot.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pytecplot
-Version: 1.2.1
+Version: 1.3.1
 Summary: A python interface to Tecplot 360
 Home-page: http://www.tecplot.com/docs/pytecplot
 Author: Tecplot, Inc.
@@ -21,11 +21,10 @@ Description: PyTecplot
         The full documentation is here: http://www.tecplot.com/docs/pytecplot
         
         .. note::
-            |PyTecplot| supports 64-bit Python versions 2.7 and 3.5+. |PyTecplot|
-            does not support 32 bit Python. Please refer to INSTALL.rst for
-            installation instructions and environment setup. For the best
-            experience, developers are encouraged to use the **latest version of
-            Python**.
+        	|PyTecplot| supports 64-bit Python 3.7 or later. |PyTecplot| does not
+        	support 32 bit Python. Please refer to INSTALL.rst for installation
+        	instructions and environment setup. For the best experience, developers are
+        	encouraged to use the **latest version of Python**.
         
         Quick Start
         -----------
@@ -49,6 +48,26 @@ Description: PyTecplot
         Change Log
         ----------
         
+        PyTecplot 1.3.1
+        ^^^^^^^^^^^^^^^
+        
+        Released with Tecplot 360 2020 R2
+        
+        * New medthod: ``tp.data.extract.extract_connected_nodes()`` to create zones
+          from continguous regions.
+        * Fixed a crash on exit when running in a MacOS virtual machine.
+        * Several minor documentation corrections.
+        
+        PyTecplot 1.3.0
+        ^^^^^^^^^^^^^^^
+        
+        Released with Tecplot 360 2020 R1
+        
+        * Fixed ``probe_on_surface()`` tolerance behavior for skewed cells.
+        * New methods: export of time-series animation videos.
+        * Current FEA loader version updated to v450.
+        * Fixed bug around setting axis ranges before data is loaded.
+        
         PyTecplot 1.2.0
         ^^^^^^^^^^^^^^^
         
@@ -384,12 +403,10 @@ Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: License :: Other/Proprietary License
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 2
-Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
 Provides-Extra: extras
 Provides-Extra: doc
 Provides-Extra: test

{pytecplot-1.2.1 → pytecplot-1.3.1r110473}/pytecplot.egg-info/SOURCES.txt

@@ -3,7 +3,6 @@ LICENSE.html
 MANIFEST.in
 README.rst
 requirements.txt
-setup.cfg
 setup.py
 tox.ini
 docs/Makefile
@@ -256,22 +255,15 @@ docs/html/_sources/api/tecplot.macros.rst.txt
 docs/html/_sources/api/tecplot.plot.rst.txt
 docs/html/_sources/api/tecplot.plot_style.rst.txt
 docs/html/_sources/api/tecplot.session.rst.txt
-docs/html/_static/ajax-loader.gif
 docs/html/_static/basic.css
 docs/html/_static/classic.css
-docs/html/_static/comment-bright.png
-docs/html/_static/comment-close.png
-docs/html/_static/comment.png
 docs/html/_static/copybutton.js
 docs/html/_static/default.css
 docs/html/_static/doctools.js
 docs/html/_static/documentation_options.js
-docs/html/_static/down-pressed.png
-docs/html/_static/down.png
 docs/html/_static/favicon.gif
 docs/html/_static/file.png
-docs/html/_static/jquery-3.2.1.js
-docs/html/_static/jquery-3.4.1.js
+docs/html/_static/jquery-3.5.1.js
 docs/html/_static/jquery.js
 docs/html/_static/language_data.js
 docs/html/_static/minus.png
@@ -284,9 +276,6 @@ docs/html/_static/searchtools.js
 docs/html/_static/sidebar.js
 docs/html/_static/underscore-1.3.1.js
 docs/html/_static/underscore.js
-docs/html/_static/up-pressed.png
-docs/html/_static/up.png
-docs/html/_static/websupport.js
 docs/html/_static/videos/aileron_roll.m4v
 docs/html/_static/videos/extract_blanked_zones.m4v
 docs/html/_static/videos/vortex_shedding.m4v

{pytecplot-1.2.1 → pytecplot-1.3.1r110473}/requirements.txt

@@ -11,4 +11,3 @@ scipy
 six
 sphinx
 tox
-

{pytecplot-1.2.1 → pytecplot-1.3.1r110473}/setup.py

@@ -95,12 +95,10 @@ def setup_opts():
             'Topic :: Software Development :: Libraries :: Python Modules',
             'License :: Other/Proprietary License',
             'Programming Language :: Python',
-            'Programming Language :: Python :: 2',
-            'Programming Language :: Python :: 2.7',
             'Programming Language :: Python :: 3',
-            'Programming Language :: Python :: 3.6',
             'Programming Language :: Python :: 3.7',
             'Programming Language :: Python :: 3.8',
+            'Programming Language :: Python :: 3.9',
         ],
         keywords=[
             'tecplot',
@@ -132,7 +130,7 @@ if __name__ == '__main__':
     import struct
 
     if sys.version_info[:2] < (2, 7):
-        raise Exception('PyTecplot only supports Python versions 2.7 and 3.6+')
+        raise Exception('PyTecplot only supports Python 3.7 or later')
 
     pointer_size = struct.calcsize('P')
     if pointer_size != 8:

{pytecplot-1.2.1 → pytecplot-1.3.1r110473}/tecplot/constant.py

@@ -227,7 +227,8 @@ class BinaryFileVersion(_Enum):
     Tecplot2006 = 0
     Tecplot2008 = 1
     Tecplot2009 = 2
-    Current = Tecplot2009
+    Tecplot2019 = 3
+    Current = Tecplot2019
 
 
 class IJKLines(_Enum):
@@ -264,7 +265,8 @@ class FEALoaderVersion(_Enum):
     v436 = '436'
     v443 = '443'
     v446 = '446'
-    Current = v446
+    v450 = '450'
+    Current = v450
 
 
 class FunctionDependency(_Enum):

{pytecplot-1.2.1 → pytecplot-1.3.1r110473}/tecplot/data/extract.py

@@ -433,10 +433,69 @@ def extract_slice(origin=(0, 0, 0), normal=(0, 0, 1), source=None,
 
 
 @tecutil.lock()
-def extract_zones_from_connected_regions(zones):
-    with tecutil.IndexSet(zones) as zone_set:
-        if not _tecutil.ExtractZonesFromConnectedRegions(zone_set):
-            raise TecplotSystemError()
+def extract_connected_regions(*zones, **kwargs):
+    """Create new zones from regions of connected cells.
+
+    Parameters:
+        *zones (`Zones`_, required): Source zones from which to extract
+            connected regions. All source zones must be finite-element
+            zones, either classic FE or polygonal/polyhedral.
+
+    Keyword Arguments:
+        assign_strand_ids (`bool`, optional): Automatically assign strand IDs
+            to the zones extracted from transient sources.  If True the
+            resulting zones will be all be assigned to the same newly created
+            strand id. (default: `True`)
+        frame (`Frame`, optional): A `Frame` that holds the `Dataset` to
+            operate on which must match *dataset* if given. (default: currently
+            active `Frame`)
+        dataset (`Dataset`, optional): The `Dataset` to operate on which must
+            be attached to *frame* if given. (default: currently active
+            `Dataset`)
+
+    Returns:
+        A `list` of the extracted `Zones <data_access>`.
+
+    .. versionadded:: 2020.2
+        Extracting connected regions requires Tecplot 360 2020 R2 or later.
+    """
+    if __debug__:
+        if version.sdk_version_info < (2020, 2):
+            msg = 'Extracting connected regions not supported.'
+            raise TecplotOutOfDateEngineError((2020, 2), msg)
+
+    if not zones:
+        msg = 'extract_connected_regions(*zones) requires at least one zone'
+        raise TecplotLogicError(msg)
+    assign_strand_ids = kwargs.get('assign_strand_ids', True)
+    frame = kwargs.get('frame', None)
+    dataset = kwargs.get('dataset', None)
+
+    if dataset is None:
+        if frame is None:
+            frame = layout.active_frame()
+        dataset = frame.dataset
+    elif frame is None:
+        frame = dataset.frame
+
+    if __debug__:
+        if not frame.has_dataset:
+            msg = 'The specified frame (or active frame if no frame is ' + \
+                  'specified) must have a data set.'
+            raise TecplotLogicError(msg)
+
+    nzones = dataset.num_zones
+
+    zone_tuple = tecutil.flatten_args(*zones)
+    with frame.activated():
+        with tecutil.ArgList() as arglist, \
+            tecutil.IndexSet(zone_tuple) as zone_set:
+            arglist[sv.SOURCEZONES] = zone_set
+            arglist[sv.FRAME] = frame.uid
+            arglist[sv.AUTOSTRANDTRANSIENTDATA] = assign_strand_ids
+            if not _tecutil.ExtractConnectedRegionsX(arglist):
+                raise TecplotSystemError()
+        return [dataset.zone(i) for i in range(nzones, dataset.num_zones)]
 
 
 @tecutil.lock()

{pytecplot-1.2.1 → pytecplot-1.3.1r110473}/tecplot/data/query.py

@@ -232,7 +232,12 @@ def probe_on_surface(positions=((0,),(0,),(0,)), zones=None, variables=None,
         closest position on highly varying surfaces. This can be addressed by
         first increasing **num_nearest_nodes** to search more of the zones and
         then by increasing the **tolerance** to allow for imprecise position
-        data.
+        data - skewed polygons for example.
+
+        All nodes of each cell considered are checked for co-planarity. This
+        check can be relaxed slightly by increasing the **tolerance**
+        parameter. The nearest position calculation will then be made assuming
+        the cells are planar and the resulting positions may be imprecise.
 
     Example usage:
 

{pytecplot-1.2.1 → pytecplot-1.3.1r110473}/tecplot/export/__init__.py

@@ -2,9 +2,12 @@ from .animation import (animation, animation_avi, animation_flash,
                         animation_mpeg4, animation_raster_metafile,
                         animation_wmv)
 from .time_animation import (save_time_animation, save_time_animation_avi,
+                             save_time_animation_bmp,
                              save_time_animation_flash,
+                             save_time_animation_jpeg,
                              save_time_animation_mpeg4,
+                             save_time_animation_png,
                              save_time_animation_raster_metafile,
-                             save_time_animation_wmv)
+                             save_time_animation_tiff, save_time_animation_wmv)
 from .image import (save_bmp, save_eps, save_jpeg, save_png, save_ps,
                     save_tiff, save_wmf)

{pytecplot-1.2.1 → pytecplot-1.3.1r110473}/tecplot/export/animation.py

@@ -15,7 +15,8 @@ class animation(object):
                  region=ExportRegion.AllFrames, supersample=3,
                  compression=None, image_type=None,
                  multiple_color_tables=False, format_options=None,
-                 format=None):
+                 convert_to_256_colors=None, jpeg_encoding=None, quality=None,
+                 gray_scale_depth=None, tiff_byte_order=None, format=None):
         if __debug__:
             if (
                 compression is not None and
@@ -40,6 +41,12 @@ class animation(object):
             'swf': ExportFormat.Flash,
             'rm': ExportFormat.RasterMetafile,
             'wmv': ExportFormat.WMV,
+
+            # image formats
+            'bmp': ExportFormat.BMP,
+            'jpeg': ExportFormat.JPEG,
+            'png': ExportFormat.PNG,
+            'tiff': ExportFormat.TIFF,
         }
         if format is None:
             format = _ext.get(os.path.splitext(filename)[-1].split('.')[-1],
@@ -63,6 +70,13 @@ class animation(object):
         self.multiple_color_tables = multiple_color_tables
         self.format_options = format_options
 
+        # image format options
+        self.convert_to_256_colors = convert_to_256_colors
+        self.jpeg_encoding = jpeg_encoding
+        self.quality = quality
+        self.gray_scale_depth = gray_scale_depth
+        self.tiff_byte_order = tiff_byte_order
+
     @tecutil.lock()
     def setup(self):
         export_setup = ExportSetup()
@@ -84,6 +98,14 @@ class animation(object):
             export_setup.mpeg_format_options = self.format_options
         elif self.format == ExportFormat.WMV:
             export_setup.wmv_format_options = self.format_options
+        elif self.format in [ExportFormat.BMP, ExportFormat.PNG]:
+            export_setup.convert_to_256_colors = self.convert_to_256_colors
+        elif self.format == ExportFormat.JPEG:
+            export_setup.jpeg_encoding = self.jpeg_encoding
+            export_setup.quality = self.quality
+        elif self.format == ExportFormat.TIFF:
+            export_setup.gray_scale_depth = self.gray_scale_depth
+            export_setup.tiff_byte_order = self.tiff_byte_order
 
     @tecutil.lock()
     def __enter__(self):

{pytecplot-1.2.1 → pytecplot-1.3.1r110473}/tecplot/export/image.py

@@ -201,27 +201,24 @@ def save_jpeg(filename, width=800, region=ExportRegion.AllFrames,
             then everything shown in the workspace will be exported. (default:
             `ExportRegion.AllFrames`)
         supersample (`int`, optional): |export_supersample_description|
-        quality (`int` 1-100, optional)
-            Select the quality of JPEG image.
-            Higher quality settings produce larger files and better
-            looking export images. Lower quality settings produce smaller files.
+        encoding (`JPEGEncoding`, optional)     Encoding method for the JPEG
+            file which may be one of the following:         *
+            `JPEGEncoding.Standard`             Creates a JPEG which downloads
+            one line at a time,             starting at the top line.         *
+            `JPEGEncoding.Progressive`             Creates a JPEG image that
+            can be displayed with             a "fade in" effect in a browser.
+            This is sometimes useful when viewing the JPEG in a
+            browser with a slow connection, since it allows             an
+            approximation of the JPEG to be drawn immediately,             and
+            the browser does not have to wait for the entire             image
+            to download.
+
+            (default: `JPEGEncoding.Standard`)
+        quality (`int` 1-100, optional)     Select the quality of JPEG image.
+            Higher quality settings produce larger files and better     looking
+            export images. Lower quality settings produce smaller files.
             For best results, use a quality setting of **75** or higher.
             (default: **75**)
-        encoding (`JPEGEncoding`, optional)
-            Encoding method for the JPEG file which may be one of the following:
-                * `JPEGEncoding.Standard`
-                    Creates a JPEG which downloads one line at a time,
-                    starting at the top line.
-                * `JPEGEncoding.Progressive`
-                    Creates a JPEG image that can be displayed with
-                    a "fade in" effect in a browser.
-                    This is sometimes useful when viewing the JPEG in a
-                    browser with a slow connection, since it allows
-                    an approximation of the JPEG to be drawn immediately,
-                    and the browser does not have to wait for the entire
-                    image to download.
-
-                (default: `JPEGEncoding.Standard`)
 
     Raises:
         `TecplotSystemError`: The image could not be saved due to a
@@ -288,49 +285,37 @@ def save_tiff(filename, width=800, region=ExportRegion.AllFrames,
             `ExportRegion.AllFrames`)
         supersample (`int`, optional): |export_supersample_description|
         convert_to_256_colors (`Boolean <bool>`, optional): |export_convert256_description|
-        gray_scale_depth (`int`, optional)
-            Export a gray-scale TIFF.
-            The ``gray_scale_depth`` parameter may be
-            set to a depth of **1-8**
-
-            ``gray_scale_depth`` specifies the
-            number of shades of gray by how many bits of gray scale
-            information is used per pixel.
-            The larger the number of bits per pixel, the larger the
-            resulting file.
-
-            Options are:
-                * **0**: On/Off
-                    One bit per pixel using an on/off strategy.
-                    All background pixels are made white (on),
-                    and all foreground pixels, black (off).
-                    This setting creates small files and is
-                    good for images with lots of background, such as line
-                    plots and contour lines.
-                * **1**: 1 Bit per Pixel
-                    One bit per pixel using gray scale values of
-                    pixels to determine black or white.
-                    Those pixels that are more than 50 percent gray are
-                    black; the rest are white. This setting creates small
-                    files that might be useful for a rough draft
-                    or a preview image.
-                * **4**: 4 Bits per Pixel
-                    Four bits per pixel resulting
-                    in sixteen levels of gray scale. This setting
-                    generates fairly small image files with a
-                    fair number of gray levels.
-                    This setting works well for most preview image purposes.
-                * **8**:  8 Bits per Pixel
-                    Eight bits per pixel resulting in 256 levels of gray.
-                    This setting is useful for full image
-                    representation, but the files generated by this
-                    setting can be large.
-
-                (default: `None`)
-
-        byte_order (`TIFFByteOrder`, optional)
-            Specify the byte order (Intel or Motorola) of the TIFF image.
-            (Default: `TIFFByteOrder.Intel`)
+        gray_scale_depth (`int`, optional)     Export a gray-scale TIFF.
+            The ``gray_scale_depth`` parameter may be     set to a depth of
+            **1-8**
+
+            ``gray_scale_depth`` specifies the number of shades of gray by how
+            many bits of gray scale information is used per pixel. The larger
+            the number of bits per pixel, the larger the resulting file.
+
+            Options are:     * **0**: On/Off         One bit per pixel using an
+            on/off strategy.         All background pixels are made white (on),
+            and all foreground pixels, black (off).         This setting
+            creates small files and is         good for images with lots of
+            background, such as line         plots and contour lines.     *
+            **1**: 1 Bit per Pixel         One bit per pixel using gray scale
+            values of         pixels to determine black or white.         Those
+            pixels that are more than 50 percent gray are         black; the
+            rest are white. This setting creates small         files that might
+            be useful for a rough draft         or a preview image.     *
+            **4**: 4 Bits per Pixel         Four bits per pixel resulting
+            in sixteen levels of gray scale. This setting         generates
+            fairly small image files with a         fair number of gray levels.
+            This setting works well for most preview image purposes.     *
+            **8**:  8 Bits per Pixel         Eight bits per pixel resulting in
+            256 levels of gray.         This setting is useful for full image
+            representation, but the files generated by this         setting can
+            be large.
+
+            (default: `None`)
+        byte_order (`TIFFByteOrder`, optional)     Specify the byte order
+            (Intel or Motorola) of the TIFF image.     (Default:
+            `TIFFByteOrder.Intel`)
 
     Raises:
         `TecplotSystemError`: The image could not be saved due to a