pytecplot 1.7.3__py3-none-any.whl → 1.7.5__py3-none-any.whl

{pytecplot-1.7.3.dist-info → pytecplot-1.7.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytecplot
-Version: 1.7.3
+Version: 1.7.5
 Summary: A Python interface to Tecplot 360
 Author-email: "Tecplot, Inc." <support@tecplot.com>
 License-Expression: LicenseRef-Tecplot-Software-License
@@ -107,6 +107,20 @@ 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.5
+^^^^^^^^^^^^^^^
+
+* Fixed: type handling of `ignore_divide_by_zero` argument in `execute_equation()`.
+
+PyTecplot 1.7.4
+^^^^^^^^^^^^^^^
+
+* Fixed a bug where loading data files failed with the error:
+  `TypeError: Field tecrpc.Argument.int64: Expected an int, got a boolean.`
+  which was due to changes in the underlying RPC message system.
+* Added `include_custom_labels` parameter to `save_tecplot_plt()` and
+  `save_tecplot_ascii()` to allow for writing out data files without custom labels.
+
 PyTecplot 1.7.3
 ^^^^^^^^^^^^^^^
 

{pytecplot-1.7.3.dist-info → pytecplot-1.7.5.dist-info}/RECORD

@@ -1,9 +1,9 @@
-pytecplot-1.7.3.dist-info/licenses/LICENSE.html,sha256=I240fAHgxqlSQn_eSmb9ktcS4hgugObDnHYQnlEPzt8,28492
+pytecplot-1.7.5.dist-info/licenses/LICENSE.html,sha256=I240fAHgxqlSQn_eSmb9ktcS4hgugObDnHYQnlEPzt8,28492
 tecplot/__init__.py,sha256=iHAPbGDgIh7HtLWaWcDYfVS4TOsNrRSHyQa-H_6Li3g,3550
-tecplot/constant.py,sha256=DJ641ugRqAQNd8uQITFbhbyEK3JwR9QhfG_CteUn5s4,8686
+tecplot/constant.py,sha256=KoqTkjfi6xjxolWeYNSUXwh27iBR8DnemNnwdZ2s4GM,8740
 tecplot/exception.py,sha256=YB4zeL0-07yCy4pyUqeFdNQ98nK11h2n3ZHHe58Od6s,6493
 tecplot/macro.py,sha256=uE29ftjdr2HdlFVa9SS-1uBU8Di4W3PwquhI75LnvhM,13307
-tecplot/version.py,sha256=dJQPI9B2wTzxrQjUGKCiAvoBwhA3Mz4v4bH5Hz31OSQ,1544
+tecplot/version.py,sha256=A5b3c-YNmQwFJ739MW1oGYkIXgvzE856yW9Ov1RgClQ,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,19 +12,19 @@ tecplot/annotation/image.py,sha256=6v_EUYQ1gUoHIqMlJXO68S8nSuvwSnPHePwRKmtmYM4,5
 tecplot/annotation/iter.py,sha256=s9rFJLhKgJKApxxTghRFBjT6Pmu6BAEfvB5QgBI4mNI,3709
 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/__init__.py,sha256=_fc25c9cRzTROoxSg0t6OqwKH9fwePVed-dvX8mXU4E,1968
 tecplot/data/array.py,sha256=wcGIaoVbSjSdwQP3DpXAOECHAmjTBurbmZvTodF5h1E,24246
 tecplot/data/create.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-tecplot/data/dataset.py,sha256=psNqhCXa6dfm05Rs7c8YvK6QwHOCDxQZjSphCkvOeAU,82337
+tecplot/data/dataset.py,sha256=MvM1vVf5NlHaDc3rI6mQV_mjNxOaGVuBsGGRtLXSG3I,81909
 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
-tecplot/data/load.py,sha256=Z7UsMWn0f1loXzxSOMXj4F2H7O9CxlLtZzXnPNvgotY,109490
+tecplot/data/load.py,sha256=eKbscSG3HxPxz_N0EbR2lz5ScbZSrkGQx3Ppd5lGFrI,114141
 tecplot/data/nodemap.py,sha256=AhSGO_Bmw3OB01UYKmjldTOci5rlUMGK_eiDrDHWrxk,36209
-tecplot/data/operate.py,sha256=oFBOzLPYnA8hUCaeiTdpPXdFlLZNLoQCb-EHcPE5iDA,42593
+tecplot/data/operate.py,sha256=pRmFVFgUbxp07mtG_mLo8LKeQwuYYg6IUl8tWkg0PPU,42659
 tecplot/data/query.py,sha256=Ocr9h1I2bFuJFLVOFEqiCUnuxTzD4wnToNzYk996GhY,14807
-tecplot/data/save.py,sha256=_535HsEUopTgWl-9NzDkYOQH2FDfTUO2k4EypOnsfrU,16609
+tecplot/data/save.py,sha256=iTmR7DJL3iUDgHOikFRPkMRejmZrNaeX7BHpZqhI4aY,16991
 tecplot/data/variable.py,sha256=xJCOO5ZeXCAFWKJYnC_mMxWKoy-oe3pE0EnHytZOwro,9437
 tecplot/data/zone.py,sha256=LxtlinZ2ejq9UnOvapQ2wZfkMdjjRTR6wCi-lzXVa6M,35207
 tecplot/export/__init__.py,sha256=eX3hx-FX9zEE-D3Nnfm_5rEG-jq6XufUDZmmRaLnKFw,781
@@ -36,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=B7KGjc8JdpKeojGZyH6oBI4ZQQmpbaL0IJtlh7HkFRY,51813
+tecplot/layout/frame.py,sha256=m6Z1JQ96k4CloN_qmvPJwOIfhPrIwnJ_1NzQK8kTv-4,51917
 tecplot/layout/layout.py,sha256=vcrqWgOkcEW90VCbLG2-7xSWajPhP3cRsLnRIrcuO4c,16025
 tecplot/layout/page.py,sha256=MqX3jJAd3o2xkfaSGXU7TD4gnXv-9CQcDj5WJnlIisU,18264
 tecplot/legend/__init__.py,sha256=zj94bHuUKvgWxn5dddEuahKCXVDMOFonQNgKxtuNSTQ,185
@@ -77,23 +77,23 @@ tecplot/session/style.py,sha256=djEwXG3H8_izU1Zsk5b7FlJo-WsxgLzb3N78YHCC7Us,1761
 tecplot/tecutil/__init__.py,sha256=tvHnjGACyMsVN7WbYrtp8Lo9qRBQymYZlQ5BuyiBMQg,748
 tecplot/tecutil/arglist.py,sha256=Ls2PIplqW2mpjPEyUryeiGcKJrrAZNFHRupBHF3mOp4,9071
 tecplot/tecutil/captured_output.py,sha256=_q4pFzQvQ736AO_PAVNxlEhzIaxgZV19sBrMuLkiCB4,6373
-tecplot/tecutil/constant.py,sha256=XeUIJRNVhQ6yQHPkpztnkAJQu-GytGG90FMXjZepKgk,19402
+tecplot/tecutil/constant.py,sha256=XlGh9KOxk1FCsknu8yTuETfGrNuq4E9efEY-U8Pve9U,21784
 tecplot/tecutil/index_set.py,sha256=oF4nLpeNOu0-F7RIQUO33WWKGIvK9O6T7lQBIALxRg0,3984
 tecplot/tecutil/lock.py,sha256=rVa7hekZ7ZFZnvYgRGsWxZUty9JUbC2EZ-eO4vHzqlU,967
 tecplot/tecutil/message_pb2.py,sha256=5LLHkC4o1hiXYx7FGPLFkPvN2YzVhPT7gfVNVJg_sEU,3668
 tecplot/tecutil/preamble.py,sha256=wzpTPY3xyv8-cnWpp5q1ay0jlXRNmMEmC0UXN-xu0aU,2142
 tecplot/tecutil/stringlist.py,sha256=GMuwiP0scuyLxEUbcJFIz4DU9TLAhNdjGHDWawGGT-o,3533
-tecplot/tecutil/sv.py,sha256=v6vBV_dCtZ6E-J3K4l27NCLF-eAlQddCqY3dgJ16ztE,54618
-tecplot/tecutil/tecutil.py,sha256=RkVV3MLDd38sXHO9wqNkk-LPIW_qG8vZFST8455rKnM,696363
-tecplot/tecutil/tecutil_client.py,sha256=j3qzB9e4h07w8cO3d1Z4vDH5ZqxXcmld9reL73Wj9vg,23749
+tecplot/tecutil/sv.py,sha256=d6zufyJhfo6UHwCJV6t9yu_yFvKS2JD9Io6GkOJ40lQ,54648
+tecplot/tecutil/tecutil.py,sha256=HxPsG94wu2kZjtsY2YfaFlko4GBUP6X12pcLR89jAkw,697201
+tecplot/tecutil/tecutil_client.py,sha256=2ELrTJG2hlPoOMp6ud0bb6ciTSQTEhFpkA50QrMVB6c,23754
 tecplot/tecutil/tecutil_connector.py,sha256=HW05xfxIbSrnnpXic3DNUkXmMmo0e9Z-HhT3EoC_Mzg,37059
-tecplot/tecutil/tecutil_rpc.py,sha256=ypGDA5ktXNClT9trdK1ElGnhrsO-oTABncT2CdQkRDU,287428
+tecplot/tecutil/tecutil_rpc.py,sha256=bei8gcQPHRS1OgBZQdLSYdX6SF_M1WzAqhSp3kQK_sk,288068
 tecplot/tecutil/util.py,sha256=JgNpjE3J7Uz_QHqPrOxmHCwNnIojkZVfdKftVw_WUdo,12055
 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.7.3.dist-info/METADATA,sha256=M7oJFD5vf0qcKM9K2xNkMjtt3I8ibe3cHqgbFnd6Cqw,23052
-pytecplot-1.7.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pytecplot-1.7.3.dist-info/top_level.txt,sha256=gU7HYnAb3AVBIKRUOASdYO0QRI6hg1raLt8aN5E4o7s,8
-pytecplot-1.7.3.dist-info/RECORD,,
+pytecplot-1.7.5.dist-info/METADATA,sha256=hZc-cnh3PQaZEUiKeKmmFH9Gdmi8VZVM6DSxmrLk86c,23561
+pytecplot-1.7.5.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+pytecplot-1.7.5.dist-info/top_level.txt,sha256=gU7HYnAb3AVBIKRUOASdYO0QRI6hg1raLt8aN5E4o7s,8
+pytecplot-1.7.5.dist-info/RECORD,,

{pytecplot-1.7.3.dist-info → pytecplot-1.7.5.dist-info}/WHEEL

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

tecplot/constant.py

@@ -354,7 +354,9 @@ class FEALoader:
         v461 = '461'
         v66051 = '66051'
         v131842 = '131842'
-        Current = v131842
+        v134144 = '134144'
+        v196864 = '196864'
+        Current = v196864
 
 
 class FluentCFFLoader:

tecplot/data/__init__.py

@@ -28,7 +28,8 @@ from .fe_cell_type import FECellType
 from .load import (load_cfx, load_tecplot, load_tecplot_szl, load_cgns,
                    load_converge_cgns, load_converge_hdf5, load_converge_output,
                    load_ensight, load_fluent, load_fluent_cff, load_fvcom,
-                   load_openfoam, load_plot3d, load_stl, load_telemac, load_vtk)
+                   load_openfoam, load_plot3d, load_stl, load_telemac,
+                   load_ugrid, load_vtk)
 from .nodemap import (ClassicNodemap, ClassicNodemapArray, Nodemap,
                       NodemapSection, NodemapSectionArray)
 from .save import save_tecplot_ascii, save_tecplot_plt, save_tecplot_szl

tecplot/data/dataset.py

@@ -1,15 +1,14 @@
 import collections
 import ctypes
 import fnmatch
-import itertools as it
+
 import logging
 import re
 import warnings
 
 from collections.abc import Iterable
-from functools import reduce
 from keyword import iskeyword
-from textwrap import dedent, TextWrapper
+from textwrap import dedent
 
 from ..tecutil import _tecutil, _tecutil_connector
 from ..constant import *
@@ -386,8 +385,7 @@ class Dataset(object):
             ZoneType.FEPolygon: PolyFEZone,
             ZoneType.FEPolyhedron: PolyFEZone,
             ZoneType.FEMixed: MixedFEZone}
-        pattern_type = getattr(re, 'Pattern', getattr(re, '_pattern_type', None))
-        if isinstance(pattern, (str, pattern_type)):
+        if isinstance(pattern, (str, re.Pattern)):
             try:
                 return next(self.zones(pattern))
             except StopIteration:
@@ -412,7 +410,7 @@ class Dataset(object):
     def _zone_indices(self):
         """Zero-based indices of all enabled zones in the dataset."""
         success, ptr = _tecutil.ZoneGetEnabledByDataSetID(self.uid)
-        if not success:
+        if not success or not ptr:
             raise TecplotSystemError()
         indices = ctypes.cast(ptr, IndexSet)
         try:
@@ -436,7 +434,7 @@ class Dataset(object):
             try:
                 return [_tecutil.ZoneGetUniqueIDByDataSetID(self.uid, zone_index + 1)
                         for zone_index in self._zone_indices]
-            except:
+            except Exception as _:
                 raise err
 
     @property
@@ -455,12 +453,12 @@ class Dataset(object):
             try:
                 return [_tecutil.ZoneGetTypeByDataSetID(self.uid, zone_index + 1)
                         for zone_index in self._zone_indices]
-            except:
+            except Exception as _:
                 try:
                     with self.frame.activated():
                         return [_tecutil.ZoneGetType(zone_index + 1)
                                 for zone_index in self._zone_indices]
-                except:
+                except Exception as _:
                     raise err
 
     @property
@@ -484,7 +482,7 @@ class Dataset(object):
         """
         try:
             success, ptr = _tecutil.ZoneGetNamesByDataSetID(self.uid)
-            if not success:
+            if not success or not ptr:
                 raise TecplotSystemError()
             names = ctypes.cast(ptr, StringList)
             try:
@@ -494,17 +492,17 @@ class Dataset(object):
         except (AttributeError, TecplotSystemError) as err:
             try:
                 success, ptr = _tecutil.ZoneGetEnabledNamesByDataSetID(self.uid)
-                if not success:
+                if not success or not ptr:
                     raise TecplotSystemError()
                 names = ctypes.cast(ptr, StringList)
                 try:
                     return list(names)
                 finally:
                     names.dealloc()
-            except:
+            except Exception as _:
                 try:
                     return [z.name for z in self.zones()]
-                except:
+                except Exception as _:
                     raise err
 
     def zones(self, pattern=None):
@@ -563,18 +561,15 @@ class Dataset(object):
             ZoneType.FEMixed: MixedFEZone}
 
         if pattern:
-            pattern_type = getattr(re, 'Pattern', getattr(re, '_pattern_type', None))
-            if not isinstance(pattern, pattern_type):
+            if not isinstance(pattern, re.Pattern):
                 regex = re.compile(fnmatch.translate(pattern), re.IGNORECASE)
             else:
                 regex = pattern
 
-            if __debug__:
-                found = False
+            found = False
             for uid, typ, name in zip(self._zone_uids, self._zone_types, self.zone_names):
                 if regex.match(name):
-                    if __debug__:
-                        found = True
+                    found = True
                     yield _dispatch[typ](uid, self)
 
             if __debug__:
@@ -647,8 +642,7 @@ class Dataset(object):
         """
         if isinstance(pattern, Variable):
             return pattern
-        pattern_type = getattr(re, 'Pattern', getattr(re, '_pattern_type', None))
-        if isinstance(pattern, (str, pattern_type)):
+        if isinstance(pattern, (str, re.Pattern)):
             try:
                 return next(self.variables(pattern))
             except StopIteration:
@@ -669,7 +663,7 @@ class Dataset(object):
     def _variable_indices(self):
         """Yields zero-based indices for all enabled variables in the dataset."""
         success, ptr = _tecutil.VarGetEnabledByDataSetID(self.uid)
-        if not success:
+        if not success or not ptr:
             raise TecplotSystemError()
         indices = ctypes.cast(ptr, IndexSet)
         try:
@@ -694,7 +688,7 @@ class Dataset(object):
             try:
                 return [_tecutil.VarGetUniqueIDByDataSetID(self.uid, variable_index + 1)
                         for variable_index in self._variable_indices]
-            except:
+            except Exception as _:
                 raise err
 
     @property
@@ -718,7 +712,7 @@ class Dataset(object):
         """
         try:
             success, ptr = _tecutil.VarGetNamesByDataSetID(self.uid)
-            if not success:
+            if not success or not ptr:
                 raise TecplotSystemError()
             names = ctypes.cast(ptr, StringList)
             try:
@@ -735,10 +729,10 @@ class Dataset(object):
                     return list(names)
                 finally:
                     names.dealloc()
-            except:
+            except Exception as _:
                 try:
                     return [z.name for z in self.variables()]
-                except:
+                except Exception as _:
                     raise err
 
     def variables(self, pattern=None):
@@ -773,18 +767,15 @@ class Dataset(object):
             reference zones and variables **by name** instead of by index.
         """
         if pattern:
-            pattern_type = getattr(re, 'Pattern', getattr(re, '_pattern_type', None))
-            if not isinstance(pattern, pattern_type):
+            if not isinstance(pattern, re.Pattern):
                 regex = re.compile(fnmatch.translate(pattern), re.IGNORECASE)
             else:
                 regex = pattern
 
-            if __debug__:
-                found = False
+            found = False
             for uid, name in zip(self._variable_uids, self.variable_names):
                 if regex.match(name):
-                    if __debug__:
-                        found = True
+                    found = True
                     yield Variable(uid, self)
 
             if __debug__:
@@ -1011,8 +1002,7 @@ class Dataset(object):
         ):
             mirror_variables = [mirror_variables]
 
-        mvars = (v if isinstance(v, Variable) else self.variable(v)
-                 for v in mirror_variables)
+        mvars = map(self.variable, mirror_variables)
         mvars = ','.join([str(v.index + 1) for v in mvars])
 
         if not zones:

tecplot/data/load.py

@@ -1,15 +1,13 @@
 import getpass
 import logging
-import os
 import pathlib
 import platform
 import textwrap
-import warnings
 
 from ..tecutil import _tecutil, _tecutil_connector
 from ..constant import *
 from ..exception import *
-from .. import layout, macro, tecutil, version
+from .. import layout, tecutil
 from ..tecutil import IndexSet, StringList, lock, sv
 
 
@@ -26,6 +24,7 @@ def _tecplot_loader_load_data(arglist,
                               assign_strand_ids=None,
                               add_zones_to_existing_strands=None):
     frame = frame or layout.active_frame()
+    assert frame, 'Invalid Frame'
 
     # If read_data_option is append and there is no data, we
     # need to silently change it to "Replace in Active Frame"
@@ -997,6 +996,96 @@ def load_telemac(filenames=None,
                 assign_strand_ids=True)
 
 
+@lock()
+def load_ugrid(filename,
+               frame=None,
+               read_data_option=ReadDataOption.Append,
+               mapbc_filename=None,
+               initial_plot_type=None):
+    """Read a UGRID data file.
+
+    Parameters:
+        filename (`pathlib.Path` or `str`): Path to exactly one UGRID file to be
+            read. The filename must end with ``.b8.ugrid`` or ``.lb8.ugrid``.
+            (See note below concerning absolute and relative paths.)
+        frame (`Frame <tecplot.layout.Frame>`, optional): The `Frame
+            <tecplot.layout.Frame>` to attach the resulting `Dataset`. If
+            `None`, the currently active `Frame <tecplot.layout.Frame>` is used
+            and the zones are appended by default.
+        read_data_option (`ReadDataOption`, optional): Specify how the data
+            is loaded into Tecplot. (default: `ReadDataOption.Append`)
+
+            Possible values are:
+                * `ReadDataOption.ReplaceInActiveFrame`
+                    Remove the dataset from the active frame prior to reading in the
+                    new dataset. If other frames use the same `Dataset
+                    <tecplot.data.Dataset>` in the active frame, they will continue to
+                    use the old one.
+                * `ReadDataOption.Append`
+                    Append to the existing `Dataset <tecplot.data.Dataset>`.
+                * `ReadDataOption.Replace`
+                    Replace the `Dataset <tecplot.data.Dataset>` attached to the active
+                    frame and to all other frames that use the same `Dataset
+                    <tecplot.data.Dataset>`.
+        mapbc_filename (`pathlib.Path` or `str`, optional): Optional MAPBC file
+            used for boundary metadata. If provided, that file is used. If
+            `None` (default), the loader looks for an exact companion
+            ``.mapbc`` file with the same base name in the same directory.
+            If the selected or auto-detected ``.mapbc`` file is malformed or its
+            boundary IDs do not match the UGRID file, the loader warns and
+            continues loading UGRID data without applying MAPBC metadata.
+        initial_plot_type (`PlotType`, optional): Forces a specific type of
+            plot upon loading of the data. To have |Tecplot 360| determine the
+            most appropriate plot type for the data, use
+            `PlotType.Automatic`. Possible values are: `PlotType.Automatic`
+            (default), `Cartesian3D`, `Cartesian2D`, `XYLine`,
+            `PlotType.Sketch`, `PolarLine`.
+
+    Returns:
+        `Dataset <tecplot.data.Dataset>`: The `Dataset <tecplot.data.Dataset>` holding
+        the loaded data.
+
+    .. note:: **Absolute and relative paths with PyTecplot**
+
+        Relative paths, when used within the PyTecplot API are always from
+        Python's current working directory which can be obtained by calling
+        :func:`os.getcwd()`. This is true for batch and `connected
+        <tecplot.session.connect()>` modes. One exception to this is paths
+        within a macro command or file which will be relative to the |Tecplot
+        Engine|'s home directory, which is typically the |Tecplot 360|
+        installation directory. Finally, when connected to a remote (non-local)
+        instance of Tecplot 360, only absolute paths are allowed.
+
+        Note that backslashes must be escaped which is especially important for
+        windows paths such as ``"C:\\\\Users"`` or ``"\\\\\\\\server\\\\path"``
+        which will resolve to ``"C:\\Users"`` and ``"\\\\server\\path"``
+        respectively. Alternatively, one may use Python's raw strings:
+        ``r"C:\\Users"`` and ``r"\\\\server\\path"``
+
+    Load one UGRID file, or explicitly provide a MAPBC file::
+
+        >>> dataset = tecplot.data.load_ugrid('surface.b8.ugrid')
+        >>> dataset = tecplot.data.load_ugrid(
+        ...     'surface.b8.ugrid',
+        ...     mapbc_filename='surface.mapbc')
+
+    .. versionadded:: 2026.1
+        Loading UGRID data requires Tecplot 360 2026 R1 or later.
+
+    .. versionadded:: 1.7.5
+    """
+    with StringList('STANDARDSYNTAX', '1.0') as instr:
+        with tecutil.ArgList() as arglist:
+            arglist[sv.DATASETREADER] = 'UGRID Loader'
+            instr += ['FILENAME_UGRID', tecutil.normalize_path(filename)]
+            if mapbc_filename is not None:
+                instr += ['FILENAME_MAPBC', tecutil.normalize_path(mapbc_filename)]
+            arglist[sv.FILENAMESORINSTRUCTIONS] = instr
+            return _tecplot_loader_load_data(
+                arglist, frame=frame, read_data_option=read_data_option,
+                initial_plot_type=initial_plot_type)
+
+
 @lock()
 def load_plot3d(grid_filenames=None,
                 solution_filenames=None,
@@ -1823,7 +1912,7 @@ def load_tecplot(filenames,
         variables (`set` of `strings <str>` or `integers <int>`, optional):
             Set of `Variables <Variable>` to load.  If variable names are
             specified as strings and appending then variables will be aligned
-            with existing variables.  If variable offsets are supplied then 
+            with existing variables.  If variable offsets are supplied then
             the variables at those offsets will be loaded and aligned based
             on the value of the collapse parameter.  Use `None` to load all
             variables. (default: `None`)
@@ -1937,19 +2026,19 @@ def load_tecplot_szl(filenames,
                      szlserver_path=None):
 
 #
-#       Possible Future Enhancement.  
+#       Possible Future Enhancement.
 #       As it stands the szl loader is hardcoded to load variables by name when
 #       appending to an existing dataset.   If we want the szl loader to behave
 #       similar to the internal tecplot loader then we need to add the ability
-#       to specify a "variables" like paramter (but should not be named 
+#       to specify a "variables" like paramter (but should not be named
 #       "variables" because of conflicts with other V3 loaders that already use
 #       that for their primary load instructions.
-#       This will apply ONLY to the VarNameList and VarPositionList for the 
+#       This will apply ONLY to the VarNameList and VarPositionList for the
 #       $!READDATASET command (i.e. only applied to appending for V3 Loaders)
 #
 #       Proposed is to add:
 #
-#           appending_variables=None,   
+#           appending_variables=None,
 #
 #       Documentation then will include:
 #
@@ -1957,7 +2046,7 @@ def load_tecplot_szl(filenames,
 #           Set of `Variables <Variable>` to load.  If variable names are
 #           specified as strings and **read_data_option** is set to
 #           `ReadDataOption.Append` then variables will be aligned with
-#           existing variables.  If variable offsets are supplied then 
+#           existing variables.  If variable offsets are supplied then
 #           the variables at those offsets will be loaded.
 #           Use `None` to load all variables. (default: `None`)
 

tecplot/data/operate.py

@@ -151,7 +151,8 @@ def execute_equation(equation, zones=None, i_range=None, j_range=None,
 
             arglist[sv.VALUELOCATION] = value_location
             arglist[sv.VARDATATYPE] = variable_data_type
-            arglist[sv.IGNOREDIVIDEBYZERO] = ignore_divide_by_zero
+            if ignore_divide_by_zero is not None:
+                arglist[sv.IGNOREDIVIDEBYZERO] = 1 if ignore_divide_by_zero else 0
 
             if not _tecutil.DataAlterX(arglist):
                 raise TecplotSystemError()

tecplot/data/save.py

@@ -13,8 +13,9 @@ log = logging.getLogger(__name__)
 @lock()
 def _save_tecplot(binary, frame, dataset, filename, include_text, include_geom,
                   include_data, include_data_share_linkage,
-                  include_autogen_face_neighbors, use_point_format,
-                  associate_with_layout, zones, variables, precision, version):
+                  include_autogen_face_neighbors, include_custom_labels,
+                  use_point_format, associate_with_layout, zones, variables, precision,
+                  version):
     if dataset is None:
         if frame is None:
             frame = layout.active_frame()
@@ -47,6 +48,7 @@ def _save_tecplot(binary, frame, dataset, filename, include_text, include_geom,
             arglist[sv.INCLUDEDATASHARELINKAGE] = include_data_share_linkage
             arglist[sv.INCLUDEAUTOGENFACENEIGHBORS] = \
                 include_autogen_face_neighbors
+            arglist[sv.INCLUDECUSTOMLABELS] = include_custom_labels
             arglist[sv.ASSOCIATELAYOUTWITHDATAFILE] = associate_with_layout
             if version is not None:
                 arglist[sv.TECPLOTVERSIONTOWRITE] = BinaryFileVersion(version)
@@ -67,8 +69,8 @@ def save_tecplot_ascii(filename, frame=None, dataset=None, zones=None,
                        variables=None, include_text=None, precision=None,
                        include_geom=None, include_data=None,
                        include_data_share_linkage=None,
-                       include_autogen_face_neighbors=None,
-                       use_point_format=None):
+                       include_autogen_face_neighbors=None, use_point_format=None,
+                       include_custom_labels=None):
     """Write Tecplot ASCII data file.
 
     Parameters:
@@ -82,8 +84,7 @@ def save_tecplot_ascii(filename, frame=None, dataset=None, zones=None,
             <tecplot.data.Dataset>` to write out. If this and *frame* are both `None`,
             the `Dataset <tecplot.data.Dataset>` of the currently active `Frame
             <layout.Frame>` is used. (default: `None`)
-        include_text (`bool`, optional): Write out all text,
-            geometries and custom labels. (default: `True`)
+        include_text (`bool`, optional): Write out all text (default: `True`)
         include_geom (`bool`, optional): Write out all geometries.
             (default: `True`)
         include_data (`bool`, optional): Write out the data. Set
@@ -97,6 +98,8 @@ def save_tecplot_ascii(filename, frame=None, dataset=None, zones=None,
         include_autogen_face_neighbors (`bool`, optional): Save the
             face neighbor connectivity. This may produce very large data
             files. (default: `False`)
+        include_custom_labels (`bool`, optional): Write out any custom labels
+            in the dataset to the output data file. (default: `True`)
         use_point_format (`bool`, optional): Write out point format,
             otherwise use block format.
             (default: `False`)
@@ -157,24 +160,20 @@ def save_tecplot_ascii(filename, frame=None, dataset=None, zones=None,
                                             zones=[zone_to_save])
     """
     return _save_tecplot(
-        binary=False, frame=frame, dataset=dataset,
-        filename=filename, include_text=include_text,
-        include_geom=include_geom, include_data=include_data,
+        binary=False, frame=frame, dataset=dataset, filename=filename,
+        include_text=include_text, include_geom=include_geom, include_data=include_data,
         include_data_share_linkage=include_data_share_linkage,
         include_autogen_face_neighbors=include_autogen_face_neighbors,
-        use_point_format=use_point_format,
-        associate_with_layout=None,
-        precision=precision,
-        zones=zones, variables=variables,
-        version=None)
+        include_custom_labels=include_custom_labels, use_point_format=use_point_format,
+        associate_with_layout=None, precision=precision, zones=zones,
+        variables=variables, version=None)
 
 
 def save_tecplot_plt(filename, frame=None, dataset=None, zones=None,
-                        variables=None, version=None, include_text=None,
-                        include_geom=None, include_data=None,
-                        include_data_share_linkage=None,
-                        include_autogen_face_neighbors=None,
-                        associate_with_layout=None):
+                     variables=None, version=None, include_text=None, include_geom=None,
+                     include_data=None, include_data_share_linkage=None,
+                     include_autogen_face_neighbors=None, associate_with_layout=None,
+                     include_custom_labels=None):
     """Write Tecplot binary PLT data file.
 
     Parameters:
@@ -194,8 +193,7 @@ def save_tecplot_plt(filename, frame=None, dataset=None, zones=None,
         variables (`list` of `Variables <Variable>`, optional):
             `Variables <Variable>` to write out. If `None`, all `Variables
             <Variable>` will be saved.
-        include_text (`bool`, optional): Write out all text,
-            geometries and custom labels. (default: `True`)
+        include_text (`bool`, optional): Write out all text. (default: `True`)
         include_geom (`bool`, optional): Write out all geometries.
             (default: `True`)
         include_data (`bool`, optional): Write out the data. Set
@@ -209,6 +207,8 @@ def save_tecplot_plt(filename, frame=None, dataset=None, zones=None,
         include_autogen_face_neighbors (`bool`, optional): Save the
             face neighbor connectivity. This may produce very large data
             files. (default: `False`)
+        include_custom_labels (`bool`, optional): Write out any custom labels
+            in the dataset to the output data file. (default: `True`)
         associate_with_layout (`bool`, optional): Associate this
             data file with the current layout. Set to `False` to write the
             datafile without modifying Tecplot's current data file to layout
@@ -271,16 +271,13 @@ def save_tecplot_plt(filename, frame=None, dataset=None, zones=None,
                                             zones=[zone_to_save])
     """
     return _save_tecplot(
-        binary=True, frame=frame, dataset=dataset,
-        filename=filename, include_text=include_text,
-        include_geom=include_geom, include_data=include_data,
+        binary=True, frame=frame, dataset=dataset, filename=filename,
+        include_text=include_text, include_geom=include_geom, include_data=include_data,
         include_data_share_linkage=include_data_share_linkage,
         include_autogen_face_neighbors=include_autogen_face_neighbors,
-        use_point_format=None,
-        associate_with_layout=associate_with_layout,
-        precision=None,
-        zones=zones, variables=variables,
-        version=version)
+        include_custom_labels=include_custom_labels, use_point_format=None,
+        associate_with_layout=associate_with_layout, precision=None, zones=zones,
+        variables=variables, version=version)
 
 
 def save_tecplot_szl(filename, frame=None, dataset=None):

tecplot/layout/frame.py

@@ -68,6 +68,9 @@ class Frame(session.Style):
     dataset: Dataset = None
     """The `Dataset <tecplot.data.Dataset>` belonging to this Frame."""
 
+    has_dataset = None
+    """Property indicating the Frame has a `Dataset <tecplot.data.Dataset>`."""
+
     def __init__(self, uid, page):
         self.page = page
         self.uid = uid

tecplot/tecutil/constant.py

@@ -1,5 +1,5 @@
 #
-# This file was auto-generated on 2025-12-15 by tecgen.
+# This file was auto-generated on 2026-07-24 by tecgen.
 # IMPORTANT: DO NOT edit this file!
 #
 from enum import Enum as _Enum
@@ -349,6 +349,111 @@ class DerivPos(_Enum):
   jphalf = 3
   iphalf = 4
 
+class Dialog(_Enum):
+  ColorMap = 0
+  Equation = 1
+  MacroViewer = 2
+  ZoneMapStyle = 3
+  QuickEdit = 4
+  QuickMacroPanel = 5
+  ValueBlanking = 6
+  Probe = 7
+  ProbeAt = 8
+  NewLayout = 9
+  OpenLayout = 10
+  Save = 11
+  SaveAs = 12
+  LoadData = 13
+  WriteData = 14
+  Print = 15
+  Import = 16
+  Export = 17
+  MacroPlay = 18
+  MacroRecord = 19
+  AxisEdit = 20
+  SpatialVars = 21
+  Reset3DAxes = 22
+  ThreeDAxisLimits = 23
+  ThreeDOrientationAxis = 24
+  Streamtraces = 25
+  IsoSurfaces = 26
+  Slices = 27
+  Contour = 28
+  VectorLength = 29
+  VectorVars = 30
+  VectorArrowheads = 31
+  VectorReferenceVector = 32
+  ScatterSizeAndFont = 33
+  ScatterLegend = 34
+  ScatterReferenceSymbol = 35
+  RGBColorVarsAndRange = 36
+  RGBColorLegend = 37
+  LineMapLegend = 38
+  IJKBlanking = 39
+  DepthBlanking = 40
+  LightSource = 41
+  Advanced3DControl = 42
+  TwoDDrawOrder = 43
+  PolarDrawingOptions = 44
+  DataLabels = 45
+  StyleLinking = 46
+  Smooth = 47
+  TransformCoordinates = 48
+  Rotate2DData = 49
+  Create1DLine = 50
+  CreateRectangularZone = 51
+  CreateCircularZone = 52
+  DuplicateZone = 53
+  MirrorZone = 54
+  CreateZoneFromPolylines = 55
+  CreateZoneFromValues = 56
+  DeleteVariables = 57
+  DeleteZones = 58
+  ExtractContourLines = 59
+  ExtractFEBoundary = 60
+  ExtractIsoSurfaces = 61
+  ExtractSlices = 62
+  ExtractSliceFromPlane = 63
+  ExtractStreamtraces = 64
+  ExtractSubZone = 65
+  ExtractDiscretePoints = 66
+  ExtractPointsFromPolyline = 67
+  ExtractPointsFromGeometry = 68
+  LinearInterpolation = 69
+  InverseDistanceInterpolation = 70
+  KrigingInterpolation = 71
+  Triangulate = 72
+  DataInfo = 73
+  CurveInfo = 74
+  DataSpreadsheet = 75
+  PaperSetup = 76
+  OrderFrames = 77
+  RulerGrid = 78
+  ThreeDViewRotate = 79
+  ThreeDViewDetails = 80
+  TranslateMagnify = 81
+  PrintPreview = 82
+  ColorPreferences = 83
+  MiscPreferences = 84
+  SizePreferences = 85
+  SaveConfiguration = 86
+  SaveColorMap = 87
+  LoadColorMap = 88
+  HelpAboutTecplot = 89
+  HelpAboutAddOns = 90
+  Publish = 91
+  EditFrame = 92
+  CopyToClipboard = 93
+  ThreeDEdge = 94
+  TimeDetails = 95
+  Performance = 96
+  HelpTecplotLicensing = 97
+  GeomDetails = 98
+  BasicColorLegend = 99
+  FourierTransform = 100
+  RotateData = 101
+  AxialDuplicate = 102
+
 class DistributionRegion(_Enum):
   Point = 0
   Rake = 1
@@ -644,6 +749,11 @@ class LegendShow(_Enum):
   Never = 1
   Auto = 2
 
+class LibraryType(_Enum):
+  Foreign = 0
+  V7Standard = 1
+  V7ActiveX = 2
+
 class LightingEffect(_Enum):
   Paneled = 0
   SmoothWithCreases = 1
@@ -838,10 +948,6 @@ class RelOp(_Enum):
   EqualTo = 4
   NotEqualTo = 5
 
-class RenderAPI(_Enum):
-  OpenGL = 0
-  Vulkan = 1
-
 class Resulting1DZoneType(_Enum):
   IOrderedIfPossible = 0
   FELineSegment = 1
@@ -903,6 +1009,16 @@ class SliceSource(_Enum):
   SurfacesOfVolumeZones = 2
   LinearZones = 3
 
+class SliceSurface(_Enum):
+  XPlanes = 0
+  YPlanes = 1
+  ZPlanes = 2
+  IPlanes = 3
+  JPlanes = 4
+  KPlanes = 5
+  CVar = 6
+  Arbitrary = 7
+
 class SphereScatterRenderQuality(_Enum):
   Low = 0
   Medium = 1

tecplot/tecutil/sv.py

@@ -1,5 +1,5 @@
 #
-# This file was auto-generated on 2025-12-15 by tecgen.
+# This file was auto-generated on 2026-07-24 by tecgen.
 # IMPORTANT: DO NOT edit this file!
 #
 
@@ -577,6 +577,7 @@ GRIDLINECOLOR = 'GRIDLINECOLOR'
 GRIDLINES = 'GRIDLINES'
 GRIDORDERPERSECTION = 'GRIDORDERPERSECTION'
 GROUP = 'GROUP'
+GROUPINGVARS = 'GROUPINGVARS'
 GROUPS = 'GROUPS'
 GRSPACING = 'GRSPACING'
 HEADER = 'HEADER'

tecplot/tecutil/tecutil.py

@@ -1,5 +1,5 @@
 #
-# This file was auto-generated on 2025-12-15 by tecgen.
+# This file was auto-generated on 2026-07-24 by tecgen.
 # IMPORTANT: DO NOT edit this file!
 #
 import sys
@@ -501,6 +501,12 @@ class TecUtil(object):
                 self.handle.tecUtilBlankingIsNonDepthActive.restype = c_bool
             except AttributeError:
                 error_list.append('TecUtilBlankingIsNonDepthActive')
+            # Boolean_t TecUtilCleanGrid(UniqueID_t DataSetID, Set_pa Zones, Set_pa GroupingVars, double AbsoluteTolerance)
+            try:
+                self.handle.tecUtilCleanGrid.argtypes = [c_int64, c_void_p, c_void_p, c_double]
+                self.handle.tecUtilCleanGrid.restype = c_bool
+            except AttributeError:
+                error_list.append('TecUtilCleanGrid')
             # Boolean_t TecUtilColorMapCopyStandard(ContourColorMap_e ColorMap)
             try:
                 self.handle.tecUtilColorMapCopyStandard.restype = c_bool
@@ -1949,9 +1955,10 @@ class TecUtil(object):
                 self.handle.tecUtilDataValueSetMinMaxByZoneVar.argtypes = [c_int32, c_int32, c_double, c_double]
             except AttributeError:
                 error_list.append('TecUtilDataValueSetMinMaxByZoneVar')
-            # void TecUtilDataValueShare(EntIndex_t SourceZone, EntIndex_t DestZone, EntIndex_t Var)
+            # Boolean_t TecUtilDataValueShare(EntIndex_t SourceZone, EntIndex_t DestZone, EntIndex_t Var)
             try:
                 self.handle.tecUtilDataValueShare.argtypes = [c_int32, c_int32, c_int32]
+                self.handle.tecUtilDataValueShare.restype = c_bool
             except AttributeError:
                 error_list.append('TecUtilDataValueShare')
             # Boolean_t TecUtilDataValueUnload(EntIndex_t Zone, EntIndex_t Var)
@@ -6210,6 +6217,12 @@ class TecUtil(object):
         result = self.handle.tecUtilBlankingIsNonDepthActive()
         return result
 
+    # Boolean_t TecUtilCleanGrid(UniqueID_t DataSetID, Set_pa Zones, Set_pa GroupingVars, double AbsoluteTolerance)
+    @tecutil_preamble
+    def CleanGrid(self, data_set_id, zones, grouping_vars, absolute_tolerance):
+        result = self.handle.tecUtilCleanGrid(data_set_id, zones, grouping_vars, absolute_tolerance)
+        return result
+
     # Boolean_t TecUtilColorMapCopyStandard(ContourColorMap_e ColorMap)
     @tecutil_preamble
     def ColorMapCopyStandard(self, color_map):
@@ -7821,10 +7834,11 @@ class TecUtil(object):
     def DataValueSetMinMaxByZoneVar(self, zone, var, min_value, max_value):
         self.handle.tecUtilDataValueSetMinMaxByZoneVar(zone, var, min_value, max_value)
 
-    # void TecUtilDataValueShare(EntIndex_t SourceZone, EntIndex_t DestZone, EntIndex_t Var)
+    # Boolean_t TecUtilDataValueShare(EntIndex_t SourceZone, EntIndex_t DestZone, EntIndex_t Var)
     @tecutil_preamble
     def DataValueShare(self, source_zone, dest_zone, var):
-        self.handle.tecUtilDataValueShare(source_zone, dest_zone, var)
+        result = self.handle.tecUtilDataValueShare(source_zone, dest_zone, var)
+        return result
 
     # Boolean_t TecUtilDataValueUnload(EntIndex_t Zone, EntIndex_t Var)
     @tecutil_preamble

tecplot/tecutil/tecutil_client.py

@@ -46,7 +46,7 @@ def set_arglist_item(item, key, val):
         item.value.float64 = val[0]
 
     elif isinstance(val, (int, bool)):
-        set_scalar(item.value, c_int64, val)
+        set_scalar(item.value, c_int64, int(val))
     elif isinstance(val, Enum):
         set_scalar(item.value, c_int64, val.value)
 

tecplot/tecutil/tecutil_rpc.py

@@ -598,6 +598,14 @@ class TecUtilRPC(object):
   rep=self.sndrcv("BlankingIsNonDepthActive")
   self.chk(rep)
   return rep.args[0].boolean
+ def CleanGrid(self,data_set_id,zones,grouping_vars,absolute_tolerance):
+  args=((ValueType.Scalar,c_int64,data_set_id),
+        (ValueType.Address,c_uint64,getattr(zones,'value',zones)),
+        (ValueType.Address,c_uint64,getattr(grouping_vars,'value',grouping_vars)),
+        (ValueType.Scalar,c_double,absolute_tolerance),)
+  rep=self.sndrcv("CleanGrid",*args)
+  self.chk(rep)
+  return (rep.status == tecrpc.Reply.Success)
  def ColorMapCopyStandard(self,color_map):
   args=((ValueType.Scalar,c_int32,ContourColorMap(color_map).value),)
   rep=self.sndrcv("ColorMapCopyStandard",*args)
@@ -2155,6 +2163,7 @@ class TecUtilRPC(object):
         (ValueType.Scalar,c_int32,var),)
   rep=self.sndrcv("DataValueShare",*args)
   self.chk(rep)
+  return (rep.status == tecrpc.Reply.Success)
  def DataValueUnload(self,zone,var):
   args=((ValueType.Scalar,c_int32,zone),
         (ValueType.Scalar,c_int32,var),)
@@ -5294,6 +5303,10 @@ class TecUtilRPC(object):
   args=((ValueType.Text,None,percent_done_text),)
   rep=self.sndrcv("StatusSetPercentDoneText",*args)
   self.chk(rep)
+ def StatusSetTextShownOnIdle(self,status_message):
+  args=((ValueType.Text,None,status_message),)
+  rep=self.sndrcv("StatusSetTextShownOnIdle",*args)
+  self.chk(rep)
  def StatusStartPercentDone(self,percent_done_text,show_stop_button,show_progress_bar):
   args=((ValueType.Text,None,percent_done_text),
         (ValueType.Scalar,c_bool,show_stop_button),

tecplot/version.py

@@ -33,8 +33,8 @@ from .tecutil import _tecutil_connector
 
 Version = collections.namedtuple('V', ['major', 'minor', 'patch', 'build'])
 
-version = '1.7.3'
-build = '41d6c97'
+version = '1.7.5'
+build = '208029f'
 version_info = Version(*[int(x) for x in version.split('.')], build=build or 0)
 
 sdk_version_info = _tecutil_connector.sdk_version_info