pytecplot 1.6.3__py3-none-any.whl → 1.7.1__py3-none-any.whl

{pytecplot-1.6.3.dist-info → pytecplot-1.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pytecplot
-Version: 1.6.3
+Version: 1.7.1
 Summary: A Python interface to Tecplot 360
 Author-email: "Tecplot, Inc." <support@tecplot.com>
 Project-URL: homepage, https://www.tecplot.com/docs/pytecplot
@@ -26,10 +26,10 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: License :: Other/Proprietary License
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.8
 Description-Content-Type: text/x-rst
 License-File: LICENSE.html
@@ -49,6 +49,7 @@ Requires-Dist: pillow; extra == "test"
 Requires-Dist: coverage; extra == "test"
 Requires-Dist: scipy; extra == "test"
 Requires-Dist: tox; extra == "test"
+Requires-Dist: filetype; extra == "test"
 Provides-Extra: all
 Requires-Dist: ipython; extra == "all"
 Requires-Dist: numpy; extra == "all"
@@ -58,6 +59,7 @@ Requires-Dist: pyyaml; extra == "all"
 Requires-Dist: coverage; extra == "all"
 Requires-Dist: scipy; extra == "all"
 Requires-Dist: tox; extra == "all"
+Dynamic: license-file
 
 PyTecplot
 =========
@@ -106,6 +108,17 @@ For more information, see |Tecplot 360s release notes|.
 
 .. |Tecplot 360s release notes| replace:: `Tecplot 360's release notes <https://tecplot.com/products/tecplot-360/new-in-tecplot-360>`__
 
+PyTecplot 1.7.1
+^^^^^^^^^^^^^^^
+
+Released with Tecplot 360 2025 R1
+
+* `slice.extract()` now documents and tests potential to return single zone rather than generator.
+  Gives warning that generator will be returned in all cases in future.
+* Fixed: `extract_slice()` now obeys the `resulting_1d_zone_type` argument.
+* Added `tp.session.redraw()` to force a display refresh when in connected mode.
+* Fixed a rare bug regarding queries of passive field data from a non-active frame.
+
 PyTecplot 1.6.3
 ^^^^^^^^^^^^^^^
 

{pytecplot-1.6.3.dist-info → pytecplot-1.7.1.dist-info}/RECORD

@@ -1,8 +1,9 @@
+pytecplot-1.7.1.dist-info/licenses/LICENSE.html,sha256=I240fAHgxqlSQn_eSmb9ktcS4hgugObDnHYQnlEPzt8,28492
 tecplot/__init__.py,sha256=iHAPbGDgIh7HtLWaWcDYfVS4TOsNrRSHyQa-H_6Li3g,3550
 tecplot/constant.py,sha256=_Ws6ldiZAkkOJjGWM9PEAMR0mHZ49qcYjJVpK51E99o,8531
 tecplot/exception.py,sha256=YB4zeL0-07yCy4pyUqeFdNQ98nK11h2n3ZHHe58Od6s,6493
 tecplot/macro.py,sha256=uE29ftjdr2HdlFVa9SS-1uBU8Di4W3PwquhI75LnvhM,13307
-tecplot/version.py,sha256=BmBl2yynwg4M3ZHmogSlWcZA1-EBIRi2vB_eRajat68,1544
+tecplot/version.py,sha256=sbKcDlh7s_cFIMAuR2K0jUXLj2tLP5xSw6C3Z91mKmk,1544
 tecplot/annotation/__init__.py,sha256=FfL8JhlO6T9NTajVRtgXHp6A6PhjpO51gnVKlHMkzWA,333
 tecplot/annotation/annotation.py,sha256=B7G-BkrQ4lYBpak9RR3u7Pvdci5MGLUvNo_MnJidyY4,8481
 tecplot/annotation/geometry.py,sha256=3jnp_Ut1AQdhSUCMAJ1yFuL_epoGUoTny03cv0kl09k,12516
@@ -12,10 +13,10 @@ tecplot/annotation/iter.py,sha256=s9rFJLhKgJKApxxTghRFBjT6Pmu6BAEfvB5QgBI4mNI,37
 tecplot/annotation/polyline.py,sha256=bw-1LfpjfcHK7VZGTf7xrvHtzjlFJAegIYrU5GVdse0,12390
 tecplot/annotation/text.py,sha256=JFaaOJR1h6LyLt9vUVanQmakXtGZOguVdA-3oT8tWhQ,26471
 tecplot/data/__init__.py,sha256=apkztrNGBSS5cfyYSIYkrwU1eeRiO0GP4sHvryPJfVA,1937
-tecplot/data/array.py,sha256=kx_UPZ4MgzydzEkHhdV8YyssOuy4EzP-i4gXvvTAaxM,23885
+tecplot/data/array.py,sha256=wcGIaoVbSjSdwQP3DpXAOECHAmjTBurbmZvTodF5h1E,24246
 tecplot/data/create.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-tecplot/data/dataset.py,sha256=sXQFB3ZX9CyZPMW__uR0AmBZw8g4F0OSfkpQd5cOk_M,80705
-tecplot/data/extract.py,sha256=hVVxbU_zqlW9ZBDHuYxm5Nu2fzjvxkwsRozosTNkm60,21891
+tecplot/data/dataset.py,sha256=psNqhCXa6dfm05Rs7c8YvK6QwHOCDxQZjSphCkvOeAU,82337
+tecplot/data/extract.py,sha256=VqDqe_-VcQSKD-rRo4DSqohZElUan2dxuNlLRM_qE54,21891
 tecplot/data/face_neighbors.py,sha256=Bm77F87qtDcw2u1BWFNE9cRTc8FI9MS3Cw8YlaJsdkc,19440
 tecplot/data/facemap.py,sha256=Xhn77cZndfgUA9U014I4M_ecwj8bI98_A7DZC24-Jwk,31287
 tecplot/data/fe_cell_type.py,sha256=G2U0c1RBHvUP03_YjHGHaMk1JOkF-g9SlBlLkWXH2Yg,3911
@@ -35,7 +36,7 @@ tecplot/export/time_animation.py,sha256=lpy7mq4zQG0Wj5Q3pezHSqGbdaiX2fTOdqf3-s9t
 tecplot/extension/__init__.py,sha256=3bDQNm1kqkiWsU7MkbturRl7YuRGSv4fjvGIN_XW5no,425
 tecplot/extension/ipython.py,sha256=glcANfhj8pG5Pv_kF4NSfuyQXwgBKowQ1-nJbJGepgc,2229
 tecplot/layout/__init__.py,sha256=HvlOnhPIsFHSRDACEPN3rlOUmk9tpLNPttReGq3P3_8,1218
-tecplot/layout/frame.py,sha256=mV6l1msr-uqOCGHAfgOI-cNsiFwhjUHXYmAsukZpfSw,51606
+tecplot/layout/frame.py,sha256=B7KGjc8JdpKeojGZyH6oBI4ZQQmpbaL0IJtlh7HkFRY,51813
 tecplot/layout/layout.py,sha256=vcrqWgOkcEW90VCbLG2-7xSWajPhP3cRsLnRIrcuO4c,16025
 tecplot/layout/page.py,sha256=MqX3jJAd3o2xkfaSGXU7TD4gnXv-9CQcDj5WJnlIisU,18264
 tecplot/legend/__init__.py,sha256=zj94bHuUKvgWxn5dddEuahKCXVDMOFonQNgKxtuNSTQ,185
@@ -60,17 +61,17 @@ tecplot/plot/linking.py,sha256=HyetVeDsnUsGJtmWLURg6ylyCom0zR-0UubrVynB_fs,16775
 tecplot/plot/plot.py,sha256=WB2S4cHc0JB2wQrZSoEISpjvuXuQRZ_QXLuFaBNJuhk,60658
 tecplot/plot/rgb_coloring.py,sha256=OfcIvhQ9Tm5TQylOUttX7QcNu3CHtETBpIz7gqa9GwY,9417
 tecplot/plot/scatter.py,sha256=SFjxZThZFbJwx0q-McjvSekQ8EdepMtLVurCFo_dKZk,12609
-tecplot/plot/slice.py,sha256=cTfynvrTijZFfZyk9Y3t1Tm3LuqCqHWh7xUu_i0Zf5s,52018
+tecplot/plot/slice.py,sha256=hebSpbQYdgjmIJkI-1mUzI4Ud6eahKPiaC3ooWke9SE,52285
 tecplot/plot/streamtrace.py,sha256=kL_3SFhYnmEIdLX2OmcP4tcxysdG41e2LZ4URZEshIA,64686
 tecplot/plot/symbol.py,sha256=6p28udpGG-rOKCAb9bgsk6kWHqXYPfAQ7W-jBrtmPaA,18422
 tecplot/plot/ticks.py,sha256=Wx3myMFWJYqeE8uefTv3sZYBBAAcaK2Pg6v-0pBk56M,19252
 tecplot/plot/title.py,sha256=Eg4T5i_Z_thuISW8CJi0gh_tGwfQ84zD6J0VZcaUnP8,11162
 tecplot/plot/vector.py,sha256=soEpzmqaii-FnMUWALgWCViJp1agXh54YxIaiZZExD0,21490
 tecplot/plot/view.py,sha256=MsafFR3G2_bPMPPdtINXk_Q0h2rfW-8XzubT7ahFC6A,29473
-tecplot/session/__init__.py,sha256=MnOgbLJNEx2r8_AUEUbWws5S-IBKycXjXYa_j1fpJVU,4431
+tecplot/session/__init__.py,sha256=Kq5On_E0J0h9CbATQfI7tQShVtlubOwGFWRNE05651U,4439
 tecplot/session/aux_data.py,sha256=79910rsjRBD2ZAzlG8SYoPxYoxoJuYtGpeMaCwzUB8s,9192
 tecplot/session/config.py,sha256=UrKiaP1HIZSO1J-eV-SEPZa0LvxK80eDcQanEZNeMtw,2952
-tecplot/session/session.py,sha256=1LHd7u1oib9Sm4LPp9y2CjTdaU1k190rgBpEzf12AWc,15586
+tecplot/session/session.py,sha256=xBvfy90k6WBbUTQEFBWLm4F53_DtKp14gC-uMO8q5Xs,17908
 tecplot/session/state_changed.py,sha256=qefZrJDIO5gT8hvkrrRmq75rQwIFXKA12qrXx6TPiD4,7961
 tecplot/session/style.py,sha256=djEwXG3H8_izU1Zsk5b7FlJo-WsxgLzb3N78YHCC7Us,17619
 tecplot/tecutil/__init__.py,sha256=tvHnjGACyMsVN7WbYrtp8Lo9qRBQymYZlQ5BuyiBMQg,748
@@ -84,16 +85,15 @@ tecplot/tecutil/preamble.py,sha256=wzpTPY3xyv8-cnWpp5q1ay0jlXRNmMEmC0UXN-xu0aU,2
 tecplot/tecutil/stringlist.py,sha256=GMuwiP0scuyLxEUbcJFIz4DU9TLAhNdjGHDWawGGT-o,3533
 tecplot/tecutil/sv.py,sha256=8EUln_hn7c2FZ3QMiK9zWMSxAQdhbKmKlTLvU-9lZ-4,54100
 tecplot/tecutil/tecutil.py,sha256=Zmz8LvQ3l25QAbIZgMjZQQHgnA-r6lgYu5n-lYwNMeo,691565
-tecplot/tecutil/tecutil_client.py,sha256=pQKqImoPQRM5K_TdyHCGHwZQr0OycIeIAjRfp5l3L7o,23671
-tecplot/tecutil/tecutil_connector.py,sha256=jYUye5JoB9643FzO7UWJD72SgLOZLCimrbzT7Jm2h4k,37242
+tecplot/tecutil/tecutil_client.py,sha256=j3qzB9e4h07w8cO3d1Z4vDH5ZqxXcmld9reL73Wj9vg,23749
+tecplot/tecutil/tecutil_connector.py,sha256=HW05xfxIbSrnnpXic3DNUkXmMmo0e9Z-HhT3EoC_Mzg,37059
 tecplot/tecutil/tecutil_rpc.py,sha256=sHX6JjNXQcVjSNasH9auydbfyZoJMF56lJF0j6TxQMM,285726
 tecplot/tecutil/util.py,sha256=C8nNB3gFK6XY6l9Ue18zcPZXFrX5JJ9vO-kcA9R53U8,12038
 tecplot/text/__init__.py,sha256=hXk-XwewRyS-yxif3Wx5FS1wO5Uh6WQpRgtUiUfjNo0,112
 tecplot/text/font.py,sha256=tHMT2NGJC8rLCVCUdmxK0YN_f4hZpTevWIofwjAp7cs,6722
 tecplot/text/label_format.py,sha256=24MOvWtVZ_SKdcU16i5yEfxC-hBipmNOLQwJ_kzDr3k,12328
 tecplot/text/textbox.py,sha256=nwr0ReRC56MY5gB7Ie6UdDxrd_Os_ZI1_3n4bmOzalU,2882
-pytecplot-1.6.3.dist-info/LICENSE.html,sha256=SB6NHYAw2pnpGIjyaVCyuarotJKB1OQlgIiYq-09FiM,27908
-pytecplot-1.6.3.dist-info/METADATA,sha256=W4It_B4OttOq3ha-QuF4RM6dME37rMWhxmPQBnDsqUw,21749
-pytecplot-1.6.3.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-pytecplot-1.6.3.dist-info/top_level.txt,sha256=gU7HYnAb3AVBIKRUOASdYO0QRI6hg1raLt8aN5E4o7s,8
-pytecplot-1.6.3.dist-info/RECORD,,
+pytecplot-1.7.1.dist-info/METADATA,sha256=s_cRVL5ZILyULPUI4dskXTE2tfDzEsqLaE1Pg-igH44,22295
+pytecplot-1.7.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pytecplot-1.7.1.dist-info/top_level.txt,sha256=gU7HYnAb3AVBIKRUOASdYO0QRI6hg1raLt8aN5E4o7s,8
+pytecplot-1.7.1.dist-info/RECORD,,

{pytecplot-1.6.3.dist-info → pytecplot-1.7.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.6.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{pytecplot-1.6.3.dist-info → pytecplot-1.7.1.dist-info/licenses}/LICENSE.html

@@ -4,7 +4,7 @@
     <meta property="og:title" content="Tecplot License Agreement" />
     <meta property="og:type" content="website" />
     <meta property="og:description" content="" />
-	
+    <meta charset="UTF-8">
   </head>
   <body style="font-family:Arial">
 	
@@ -66,11 +66,11 @@
     
     <h4><span>14. Indemnity.</span></h4><p><span>Tecplot, Inc. will defend, indemnify and hold Licensee harmless from any claims, actions, suits or proceedings (each a "Claim") brought against Licensee by a third party to the extent such Claim is based on an allegation that the Software, when used in accordance with this Agreement, infringes the intellectual property rights of third parties, provided that (i) Licensee gives Tecplot, Inc. written notice of any such Claim within ten (10) business days of said claim coming to its attention, and promptly provides all authority and information required for the defense thereof, (ii) Licensee cooperates with Tecplot, Inc. in the defense of the Claim, and (iii) such Claim does not arise due to the unauthorized acts or misconduct of Licensee, any modification of the Software by Licensee, any failure by Licensee to use corrections or enhancements provided by or on behalf of Tecplot, Inc. that would rectify such infringement, or the combination of the Software with software, hardware, information, data or other materials not furnished by Tecplot, Inc. to the extent such infringement would not have occurred but for such combination. In the event that a successful Claim is brought against Licensee and Licensee's use thereof is enjoined (or if Tecplot, Inc. otherwise elects), Tecplot, Inc., at its option, shall (i) procure for Licensee the right to continue to use the Software, (ii) replace the Software with non-infringing software, or (iii) terminate this Agreement with respect to the enjoined Software and return to Licensee a pro-rated portion of the fees paid to Tecplot, Inc.&nbsp;&nbsp;</span></p>
     <h4><span>15. Confidentiality.</span></h4><p><span>The Software contains proprietary trade secrets of Tecplot, Inc., and Licensee and any unlicensed user agrees to maintain the confidentiality of the Software using at least as great a degree of care as they use to maintain the confidentiality of their own most confidential information. Licensee agrees to reasonably communicate the terms and conditions of this Agreement to those persons employed by Licensee who come into contact with the Software, and to use reasonable best efforts to ensure their compliance with such terms and conditions, including, without limitation, not knowingly permitting such persons to Use any portion of the Software for the purpose of deriving the source code of the Software or defeating any passcode.&nbsp;&nbsp;</span></p>
-    
-    <h4><span>16. Entire Agreement; Interpretation.</span></h4><p><span>This Agreement constitutes the entire agreement between parties pertaining to the subject matter hereof and supersedes all prior representations, warranties, conditions, agreements, and understandings, whether oral or written, express or implied, relating to this Agreement. No supplement, modification, or waiver of this Agreement shall be effective unless it is provided or approved by Tecplot, Inc. in writing. Any waiver or modification of this Agreement shall only be effective if it is in writing and signed by both parties hereto. The terms of purchase orders, payment documents, or similar documents you submit to Tecplot will not amend or become part of this Agreement and will not be binding on Tecplot. All such terms are hereby rejected. If any part of this Agreement is found invalid or unenforceable by a Court of competent jurisdiction, the remainder shall be interpreted so as to reasonably effect the intention of the parties.&nbsp;&nbsp;</span></p>
+    <h4><span>16. Marketing.</span></h4><p><span> Licensee hereby grants to Tecplot, Inc. a non-exclusive license to use Licensee's name, logo, trademarks, and trade names (collectively, the "Licensee Marks") in Tecplot, Inc.'s promotional and marketing material from time to time for the purpose of identifying Licensee as a customer. Tecplot, Inc. shall obtain the Licensee's written consent for any other specific use not previously approved under this Agreement. Licensee retains all rights, title, and interest in and to the Licensee Marks.&nbsp;&nbsp;</span></p>
+    <h4><span>17. Entire Agreement; Interpretation.</span></h4><p><span>This Agreement constitutes the entire agreement between parties pertaining to the subject matter hereof and supersedes all prior representations, warranties, conditions, agreements, and understandings, whether oral or written, express or implied, relating to this Agreement. No supplement, modification, or waiver of this Agreement shall be effective unless it is provided or approved by Tecplot, Inc. in writing. Any waiver or modification of this Agreement shall only be effective if it is in writing and signed by both parties hereto. The terms of purchase orders, payment documents, or similar documents you submit to Tecplot will not amend or become part of this Agreement and will not be binding on Tecplot. All such terms are hereby rejected. If any part of this Agreement is found invalid or unenforceable by a Court of competent jurisdiction, the remainder shall be interpreted so as to reasonably effect the intention of the parties.&nbsp;&nbsp;</span></p>
     
 	<div><p>&nbsp;</p></div>	
-    <p><span>Last update: February 2024</span></p>
+    <p><span>Last update: May 2025</span></p>
     
   </div>
   </body>

tecplot/data/array.py

@@ -4,8 +4,19 @@ import ctypes
 import logging
 import textwrap
 
-from ctypes import (addressof, byref, cast, c_double, c_float, c_int8, c_int16,
-                    c_int32, c_int64, c_void_p, POINTER)
+from ctypes import (
+    addressof,
+    byref,
+    cast,
+    c_double,
+    c_float,
+    c_int8,
+    c_int16,
+    c_int32,
+    c_int64,
+    c_void_p,
+    POINTER,
+)
 
 from ..tecutil import _tecutil, _tecutil_connector
 from ..constant import *
@@ -100,6 +111,7 @@ class Array(c_void_p):
         `ContourLevels.reset()` or similar. This will ensure that the total
         range of the new values is presented in the plot.
     """
+
     def __init__(self, zone, variable):
         self.zone = zone
         self.variable = variable
@@ -114,12 +126,12 @@ class Array(c_void_p):
             return False
 
     def _delete_cache(self):
-        attrs = '''
+        attrs = """
             _rnr _wnr _rrp _wrp
             _location
             _len
             _data_type
-        '''.split()
+        """.split()
         for attr in attrs:
             try:
                 delattr(self, attr)
@@ -127,12 +139,18 @@ class Array(c_void_p):
                 pass
 
     def _native_reference(self, writable=False):
-        args = (self.zone.dataset.uid, self.zone.index + 1, self.variable.index + 1)
+        args = (
+            self.zone.dataset.uid,
+            self.zone.index + 1,
+            self.variable.index + 1,
+        )
         if writable:
             if self._cache:
                 if not hasattr(self, '_wnr'):
                     with tecutil.lock():
-                        self._wnr = _tecutil.DataValueGetWritableNativeRefByUniqueID(*args)
+                        self._wnr = _tecutil.DataValueGetWritableNativeRefByUniqueID(
+                            *args
+                        )
                 return self._wnr
             else:
                 with tecutil.lock():
@@ -141,7 +159,9 @@ class Array(c_void_p):
             if self._cache:
                 if not hasattr(self, '_rnr'):
                     with tecutil.lock():
-                        self._rnr = _tecutil.DataValueGetReadableNativeRefByUniqueID(*args)
+                        self._rnr = _tecutil.DataValueGetReadableNativeRefByUniqueID(
+                            *args
+                        )
                 return self._rnr
             else:
                 with tecutil.lock():
@@ -154,8 +174,9 @@ class Array(c_void_p):
             raise TecplotLogicError(msg)
         elif writable:
             ref = self._native_reference(writable=True)
-            _tecutil.handle.tecUtilDataValueGetWritableRawPtrByRef.restype = \
-                POINTER(self.c_type)
+            _tecutil.handle.tecUtilDataValueGetWritableRawPtrByRef.restype = POINTER(
+                self.c_type
+            )
             wrp = _tecutil.DataValueGetWritableRawPtrByRef(ref)
             if self._cache:
                 if not hasattr(self, '_wrp'):
@@ -164,8 +185,9 @@ class Array(c_void_p):
             else:
                 return wrp
         else:
-            _tecutil.handle.tecUtilDataValueGetReadableRawPtrByRef.restype = \
-                POINTER(self.c_type)
+            _tecutil.handle.tecUtilDataValueGetReadableRawPtrByRef.restype = POINTER(
+                self.c_type
+            )
             rrp = _tecutil.DataValueGetReadableRawPtrByRef(self)
             if self._cache:
                 if not hasattr(self, '_rrp'):
@@ -202,6 +224,12 @@ class Array(c_void_p):
         else:
             return _tecutil.DataValueGetCountByRef(self)
 
+    def _value_location(self):
+        with self.zone.dataset.frame.activated():
+            return _tecutil.DataValueGetLocation(
+                self.zone.index + 1, self.variable.index + 1
+            )
+
     @property
     def location(self):
         """`ValueLocation`: Data points location with respect to the elements.
@@ -214,12 +242,10 @@ class Array(c_void_p):
         """
         if self._cache:
             if not hasattr(self, '_location'):
-                self._location = _tecutil.DataValueGetLocation(
-                    self.zone.index + 1, self.variable.index + 1)
+                self._location = self._value_location()
             return self._location
         else:
-            return _tecutil.DataValueGetLocation(self.zone.index + 1,
-                                                 self.variable.index + 1)
+            return self._value_location()
 
     @property
     def shape(self):
@@ -318,7 +344,8 @@ class Array(c_void_p):
             FieldDataType.Double: ctypes.c_double,
             FieldDataType.Int32: ctypes.c_int32,
             FieldDataType.Int16: ctypes.c_int16,
-            FieldDataType.Byte: ctypes.c_int8}
+            FieldDataType.Byte: ctypes.c_int8,
+        }
         return _ctypes[self.data_type]
 
     @property
@@ -360,7 +387,7 @@ class Array(c_void_p):
             >>> x = dataset.zone('Zone').values('X').as_ctypes_array()
         """
         size = (len(self) - offset) if size is None else size
-        CArray = (self.c_type * size)
+        CArray = self.c_type * size
         if copy:
             arr = CArray()
             _tecutil.DataValueArrayGetByRef(self, offset + 1, size, arr)
@@ -368,8 +395,7 @@ class Array(c_void_p):
         else:
             ptr = self._raw_pointer(True)
             if offset:
-                vptr = ctypes.cast(ctypes.pointer(ptr),
-                                   ctypes.POINTER(ctypes.c_void_p))
+                vptr = ctypes.cast(ctypes.pointer(ptr), ctypes.POINTER(ctypes.c_void_p))
                 vptr.contents.value += ctypes.sizeof(ptr._type_) * offset
             ptr_addr = ctypes.addressof(ptr.contents)
             arr = CArray.from_address(ptr_addr)
@@ -402,6 +428,7 @@ class Array(c_void_p):
             >>> x = dataset.zone('Zone').values('X').as_numpy_array()
         """
         import numpy as np
+
         carr = self.as_ctypes_array(offset, size, copy)
         return np.ctypeslib.as_array(carr)
 
@@ -441,11 +468,13 @@ class Array(c_void_p):
         try:
             return self.as_numpy_array(offset, size, copy=True)
         except ImportError:
-            msg = textwrap.dedent('''\
+            msg = textwrap.dedent(
+                """\
                 Falling back to using basic Python for data operations.
                 If installed, PyTecplot will make use of Numpy where
                 appropriate for significant performance gains.
-            ''')
+            """
+            )
             log.warning(msg)
             return self.as_ctypes_array(offset, size, copy=True)
 
@@ -506,22 +535,23 @@ class Array(c_void_p):
 
                 if isinstance(val, Array):
                     if (
-                        offset == 0 and
-                        size in (None, len(self)) and
-                        val.zone.dataset == self.zone.dataset
+                        offset == 0
+                        and size in (None, len(self))
+                        and val.zone.dataset == self.zone.dataset
                     ):
                         # copy whole array
                         if val.zone == self.zone:
-                            eqn = 'V{0} = V{1}'.format(self.variable.index + 1,
-                                                       val.variable.index + 1)
+                            eqn = 'V{0} = V{1}'.format(
+                                self.variable.index + 1, val.variable.index + 1
+                            )
                             operate.execute_equation(eqn, self.zone)
                         else:
                             src_zone_idx = self.zone.index
                             tgt_zone_idx = val.zone.index
                             var_idx = val.variable.index
-                            if not _tecutil.DataValueCopy(src_zone_idx + 1,
-                                                          tgt_zone_idx + 1,
-                                                          var_idx + 1):
+                            if not _tecutil.DataValueCopy(
+                                src_zone_idx + 1, tgt_zone_idx + 1, var_idx + 1
+                            ):
                                 raise TecplotSystemError()
                         return
                     else:
@@ -535,17 +565,20 @@ class Array(c_void_p):
                     # coerce val to a ctypes array, using numpy if available
                     try:
                         import numpy as np
+
                         nparr = np.asarray(val, dtype=ctype)
                         ptarr = nparr.ctypes.data_as(POINTER(ctype))
                         ptaddr = addressof(ptarr.contents)
                         arr = (ctype * size).from_address(ptaddr)
                     except ImportError:
-                        msg = textwrap.dedent('''\
+                        msg = textwrap.dedent(
+                            """\
                             Falling back to using basic Python for data
                             operations. If installed, PyTecplot will make use
                             of Numpy where appropriate for significant
                             performance gains.
-                        ''')
+                        """
+                        )
                         log.warning(msg)
                         arr = (ctype * size)(*val)
 
@@ -606,7 +639,7 @@ class Array(c_void_p):
 
     @property
     def shared_zones(self):
-        """`list` of `Zones <data_access>`: All `Zones <data_access>` sharing this array.
+        """`list` of `Zones <data_access>`: All zones sharing this array.
 
         Example usage::
 
@@ -616,10 +649,14 @@ class Array(c_void_p):
             0
             1
         """
-        indices = _tecutil.DataValueGetShareZoneSet(self.zone.index + 1,
-                                                    self.variable.index + 1)
-        ret = [self.zone.dataset.zone(i) for i in indices]
-        indices.dealloc()
+        with self.zone.dataset.frame.activated():
+            indices = _tecutil.DataValueGetShareZoneSet(
+                self.zone.index + 1, self.variable.index + 1
+            )
+            try:
+                ret = [self.zone.dataset.zone(i) for i in indices]
+            finally:
+                indices.dealloc()
         return ret
 
     @property
@@ -638,5 +675,7 @@ class Array(c_void_p):
             z = ds.add_ordered_zone('Z1', (3,))
             assert not z.values(0).passive
         """
-        return _tecutil.DataValueIsPassive(self.zone.index + 1,
-                                           self.variable.index + 1)
+        with self.zone.dataset.frame.activated():
+            return _tecutil.DataValueIsPassive(
+                self.zone.index + 1, self.variable.index + 1
+            )

tecplot/data/dataset.py

@@ -884,7 +884,7 @@ class Dataset(object):
             *zones (`Zone <data_access>`, optional): Specific `Zones
                 <data_access>` to copy. All zones will be copied if none are
                 supplied.
-            shared_variables (`bool` or `list` of `Variables <Variable>`):
+            share_variables (`bool` or `list` of `Variables <Variable>`):
                 Share all variables between the original and generated zones if
                 `True` or the list of Variables to be shared. Variable sharing
                 allows you to lower the use of physical memory (RAM).  When
@@ -937,9 +937,10 @@ class Dataset(object):
         if not share_variables:
             branch_variables = list(self.variables())
         elif isinstance(share_variables, Iterable):
+            share_variables = list(share_variables)
             for idx, var in enumerate(share_variables):
                 if not isinstance(var, Variable):
-                    share_variables[idx]= self.variable(var)
+                    share_variables[idx] = self.variable(var)
 
             branch_variables = [v for v in self.variables()
                                 if v not in share_variables]
@@ -1191,6 +1192,14 @@ class Dataset(object):
             corrupting loaded data, if it attempts to render (especially
             polytope) data without connectivity.
 
+            .. warning:: **Variable Sharing.**
+
+            If a new zone has the same type and shape as an existing zone,
+            variables may be shared by Tecplot to conserve memory. This
+            variable sharing can be broken with the `branch_variables()`
+            method. More information on when variable sharing occurs can be
+            found in the |Tecplot User's Manual|.
+
         .. note:: **Performance considerations for data manipulations.**
 
             When performing many data-manipulation operations including adding
@@ -1425,6 +1434,14 @@ class Dataset(object):
             corrupting loaded data, if it attempts to render (especially
             polytope) data without connectivity.
 
+            .. warning:: **Variable Sharing.**
+
+            If a new zone has the same type and shape as an existing zone,
+            variables may be shared by Tecplot to conserve memory. This
+            variable sharing can be broken with the `branch_variables()`
+            method. More information on when variable sharing occurs can be
+            found in the |Tecplot User's Manual|.
+
         .. note:: **Performance considerations for data manipulations.**
 
             When performing many data-manipulation operations including adding
@@ -1493,6 +1510,14 @@ class Dataset(object):
             corrupting loaded data, if it attempts to render (especially
             polytope) data without connectivity.
 
+            .. warning:: **Variable Sharing.**
+
+            If a new zone has the same type and shape as an existing zone,
+            variables may be shared by Tecplot to conserve memory. This
+            variable sharing can be broken with the `branch_variables()`
+            method. More information on when variable sharing occurs can be
+            found in the |Tecplot User's Manual|.
+
         .. note:: **Performance considerations for data manipulations.**
 
             When performing many data-manipulation operations including adding
@@ -1541,6 +1566,14 @@ class Dataset(object):
             corrupting loaded data, if it attempts to render (especially
             polytope) data without connectivity.
 
+            .. warning:: **Variable Sharing.**
+
+            If a new zone has the same type and shape as an existing zone,
+            variables may be shared by Tecplot to conserve memory. This
+            variable sharing can be broken with the `branch_variables()`
+            method. More information on when variable sharing occurs can be
+            found in the |Tecplot User's Manual|.
+
         .. note:: **Performance considerations for data manipulations.**
 
             When performing many data-manipulation operations including adding

tecplot/data/extract.py

@@ -411,12 +411,12 @@ def extract_slice(origin=(0, 0, 0), normal=(0, 0, 1), source=None,
                 arglist[sv.AUTOSTRANDTRANSIENTDATA] = bool(assign_strand_ids)
             if transient_mode != TransientOperationMode.SingleSolutionTime:
                 arglist[sv.TRANSIENTOPERATIONMODE] = transient_mode
+            zone_type = Resulting1DZoneType(resulting_1d_zone_type)
+            arglist[sv.RESULTING1DZONETYPE] = zone_type
             if not _tecutil.CreateSliceZoneFromPlneX(arglist):
                 raise TecplotSystemError()
             if dataset.num_zones == nzones:
                 raise TecplotLogicError('No zones found when extracting slice')
-            zone_type = Resulting1DZoneType(resulting_1d_zone_type)
-            arglist[sv.RESULTING1DZONETYPE] = zone_type
 
         if (
             mode == ExtractMode.SingleZone and

tecplot/layout/frame.py

@@ -1,13 +1,18 @@
+from __future__ import annotations
+
 import contextlib
 import ctypes
 import logging
 import numbers
+import typing
 
 from ..tecutil import _tecutil, sv
 from ..constant import *
 from ..exception import *
 from .. import annotation, constant, plot, session, tecutil
 
+if typing.TYPE_CHECKING:
+    from ..data import Dataset
 
 log = logging.getLogger(__name__)
 
@@ -60,6 +65,9 @@ class Frame(session.Style):
         print(page.name)
     """
 
+    dataset: Dataset = None
+    """The `Dataset <tecplot.data.Dataset>` belonging to this Frame."""
+
     def __init__(self, uid, page):
         self.page = page
         self.uid = uid

tecplot/plot/slice.py

@@ -3,6 +3,7 @@ from builtins import int, super
 import itertools as it
 
 from collections.abc import Iterable
+from warnings import warn
 
 from ..tecutil import _tecutil, sv
 from ..constant import *
@@ -1533,9 +1534,14 @@ class SliceGroup(SliceGroupCollection):
         result = super().extract(mode, assign_strand_ids,
                                  resulting_1d_zone_type, transient_mode)
         if (
-            mode == ExtractMode.SingleZone and
-            transient_mode == TransientOperationMode.SingleSolutionTime
+            mode == ExtractMode.SingleZone
+            and transient_mode == TransientOperationMode.SingleSolutionTime
         ):
-            return list(result)[0]
-        else:
-            return result
+            warn("extract() will always return a generator" +
+                 " in future versions of PyTecplot")
+            if (
+                self.show_primary_slice == True
+                and self.show_start_and_end_slices == False
+            ):
+                return list(result)[0]
+        return result

tecplot/session/__init__.py

@@ -34,7 +34,7 @@ not be recoverable by the |Tecplot Engine|.
 from .aux_data import AuxData
 from .config import configuration
 from .session import (acquire_license, clear_suspend, connect, connected,
-                      disconnect, license_expiration, release_license,
+                      disconnect, license_expiration, redraw, release_license,
                       start_roaming, stop, stop_roaming, suspend,
                       suspend_enter, suspend_exit)
 from .state_changed import connectivity_altered, data_altered, zone_added

tecplot/session/session.py

@@ -5,8 +5,10 @@ import logging
 import platform
 import textwrap
 
-from ..tecutil import _tecutil_connector
+from ..tecutil import _tecutil, _tecutil_connector, lock
+from ..constant import *
 from ..exception import *
+from .. import macro
 from .state_changed import _emit_state_changes
 
 
@@ -155,12 +157,14 @@ def start_roaming(days):
         Your PyTecplot roaming license has been checked in.
     """
     if _tecutil_connector.connected:
-        msg = textwrap.dedent('''\
+        msg = textwrap.dedent(
+            """\
             Roaming PyTecplot is not available when connected.
             To roam PyTecplot, first disconnect with
             tecplot.session.disconnect(). Roaming with Tecplot 360
             is available under Help -> License Roaming.
-        ''')
+        """
+        )
         raise TecplotLogicError(msg)
     _tecutil_connector.start_roaming(days)
 
@@ -179,12 +183,14 @@ def stop_roaming(force=False):
         Your PyTecplot roaming license has been checked in.
     """
     if _tecutil_connector.connected:
-        msg = textwrap.dedent('''\
+        msg = textwrap.dedent(
+            """\
             Roaming PyTecplot is not available when connected.
             To roam PyTecplot, first disconnect with
             tecplot.session.disconnect(). Roaming with Tecplot 360
             is available under Help -> License Roaming.
-        ''')
+        """
+        )
         raise TecplotLogicError(msg)
     _tecutil_connector.stop_roaming(force)
 
@@ -421,5 +427,55 @@ def clear_suspend():
     _tecutil_connector.client.clear_suspend_interface()
 
 
+def redraw():
+    """Force a refresh of all plots on the screen (connected mode only).
+
+    Forcibly updates all plots and renders everything to the screen. This is useful when
+    connected to a live instance of Tecplot 360 where updates faster than one second
+    (the default) is desired. This command is ignored in batch mode.
+
+    Eample usage::
+
+        for i in range(10):
+            zone.values('s')[:] = new_data
+            tp.session.redraw() # force redraw on screen before continuing script
+
+    .. versionadded:: 1.7
+        `redraw()` added in PyTecplot 1.7.0.
+
+    .. versionadded:: 2025.1
+        Forcing a redraw is supported in Tecplot 360 2025 R1 and later. For earlier
+        versions of Tecplot 360, the redraw is deferred but guaranteed to happen
+        within one second after the call.
+    """
+    tuclient = _tecutil_connector.client
+    if tuclient:
+        try:
+            """
+            Developer's note:
+                The TecUtilServer goes to great length to shutdown the user interface to
+                keep processing PyTecplot scripts in connected mode fast. Drawing to the
+                screen in Tecplot 360 requires that the Tecplot engine take control
+                which means the server must release it's control. We do this by
+                temporarily setting the server to "single command" mode, then asking if
+                automatic redraw is active. If it is, then the interface will
+                immediately draw. If not, then we just toggle it on then off which will
+                cause the whole workarea to redraw, updating anything that was changed
+                since the last draw.
+            """
+            tuclient.processing_mode = TecUtilServerProcessingMode.Single
+            if not _tecutil.AutoRedrawIsActive():
+                try:
+                    macro.execute_command('''
+                        $!Interface AutoRedraw { IsActive=True }
+                    ''')
+                finally:
+                    macro.execute_command('''
+                        $!Interface AutoRedraw { IsActive=False }
+                    ''')
+        finally:
+            tuclient.processing_mode = TecUtilServerProcessingMode.Unspecified
+
+
 # Ensure the Tecplot engine is cleaned up on exit if started.
 atexit.register(stop)

tecplot/tecutil/tecutil_client.py

@@ -318,9 +318,10 @@ class TecUtilClient(TecUtilRPC):
             ERRMSG = 'Could not perform handshake with preferred method'
 
             msg = bytes(self.socket.recv())
+            log.debug(f'received message: {msg}')
 
             if len(msg) < 10:
-                raise TecplotInvalidMessage(ERRMSG + ' (response too small')
+                raise TecplotInvalidMessage(ERRMSG + ' (response too small)')
             if msg[0] != RAWMSG:
                 raise TecplotInvalidMessage(ERRMSG + ' (not a raw message)')
 
@@ -459,9 +460,9 @@ class TecUtilClient(TecUtilRPC):
         assert self.socket is not None
 
         if self.tuserver_version < 2:
-            log.warn('This version of the TecUtil Server addon does not'
-                     ' support the suspended interface context. Please update'
-                     ' to the newest version of Tecplot 360.')
+            log.warning('This version of the TecUtil Server addon does not'
+                        ' support the suspended interface context. Please update'
+                        ' to the newest version of Tecplot 360.')
             yield
         else:
             if self.suspended:
@@ -485,9 +486,9 @@ class TecUtilClient(TecUtilRPC):
     @processing_mode.setter
     def processing_mode(self, mode):
         if self.tuserver_version < 6:
-            log.warn('This version of the TecUtil Server addon does not'
-                     ' support different processing modes. Please update'
-                     ' to the newest version of Tecplot 360.')
+            log.warning('This version of the TecUtil Server addon does not'
+                        ' support different processing modes. Please update'
+                        ' to the newest version of Tecplot 360.')
             return
 
         request = tecrpc.Request()
@@ -512,9 +513,9 @@ class TecUtilClient(TecUtilRPC):
     @logging_level.setter
     def logging_level(self, level):
         if self.tuserver_version < 6:
-            log.warn('This version of the TecUtil Server addon does not'
-                     ' support adjusting the logging level. Please update'
-                     ' to the newest version of Tecplot 360.')
+            log.warning('This version of the TecUtil Server addon does not'
+                        ' support adjusting the logging level. Please update'
+                        ' to the newest version of Tecplot 360.')
             return
 
         request = tecrpc.Request()

tecplot/tecutil/tecutil_connector.py

@@ -119,7 +119,7 @@ class TecUtilConnector(object):
                 msg = 'required Python module: protobuf'
                 raise ImportError(msg)
             else:
-                # protobuf installed, both not working
+                # protobuf installed but not working
                 msg = 'invalid message received on port {}'.format(port)
                 raise TecplotInvalidMessage(msg + '\n' + str(err_pb))
 
@@ -442,10 +442,7 @@ class TecUtilConnector(object):
 
             Try running python using the tec360-env script included in the
             Tecplot 360 bin folder:
-                "/Applications/Tecplot 360 EX [VERSION]/bin/tec360-env" -- python [options]
-
-            On Apple Silicon machines, an Intel version of Python is required:
-                "/Applications/Tecplot 360 EX [VERSION]/bin/tec360-env" -- python3-intel64 [options]''')
+                "/Applications/Tecplot 360 EX [VERSION]/bin/tec360-env" -- python [options]''')
 
         if self.libbatch_path is None:
             raise TecplotLibraryNotFoundError(errmsg)

tecplot/version.py

@@ -33,8 +33,8 @@ from .tecutil import _tecutil_connector
 
 Version = collections.namedtuple('V', ['major', 'minor', 'patch', 'build'])
 
-version = '1.6.3'
-build = 'f1ee370'
+version = '1.7.1'
+build = 'd6b04de'
 version_info = Version(*[int(x) for x in version.split('.')], build=build or 0)
 
 sdk_version_info = _tecutil_connector.sdk_version_info