pytecplot 1.7.4__py3-none-any.whl → 1.8.0__py3-none-any.whl

{pytecplot-1.7.4.dist-info → pytecplot-1.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytecplot
-Version: 1.7.4
+Version: 1.8.0
 Summary: A Python interface to Tecplot 360
 Author-email: "Tecplot, Inc." <support@tecplot.com>
 License-Expression: LicenseRef-Tecplot-Software-License
@@ -26,10 +26,12 @@ Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Python: >=3.8
+Classifier: Programming Language :: Python :: 3.15
+Requires-Python: >=3.11
 Description-Content-Type: text/x-rst
 License-File: LICENSE.html
 Requires-Dist: protobuf>=3.20.0
@@ -75,11 +77,11 @@ Documentation
 The full documentation is here: https://www.tecplot.com/docs/pytecplot
 
 .. note::
-    |PyTecplot| is supported on the three latest releases of Python, 64-bit
-    only. |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 the Python versions actively maintained by the Python
+    Software Foundation, 64-bit only.
+    |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 supported version of Python**.
 
 Quick Start
 -----------
@@ -107,6 +109,22 @@ 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.8.0
+^^^^^^^^^^^^^^^
+
+* Added surface-flow effect controls, including line integral convolution, for
+  Tecplot 360 2026 R1 and later.
+* Added `tp.data.load_ugrid()` for loading exactly one `.b8.ugrid` or
+  `.lb8.ugrid` file per call with an optional explicit `mapbc_filename`.
+* Documented UGRID MAPBC behavior in the API reference, including companion
+  `.mapbc` auto-discovery when `mapbc_filename=None`.
+* Current FEA loader version updated to v196864.
+
+PyTecplot 1.7.5
+^^^^^^^^^^^^^^^
+
+* Fixed: type handling of `ignore_divide_by_zero` argument in `execute_equation()`.
+
 PyTecplot 1.7.4
 ^^^^^^^^^^^^^^^
 

{pytecplot-1.7.4.dist-info → pytecplot-1.8.0.dist-info}/RECORD

@@ -1,9 +1,9 @@
-pytecplot-1.7.4.dist-info/licenses/LICENSE.html,sha256=I240fAHgxqlSQn_eSmb9ktcS4hgugObDnHYQnlEPzt8,28492
+pytecplot-1.8.0.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=m28NzZOI2Idf7k94m2r0_AtcJ-BqtkqGyc1LpvMdhvU,1544
+tecplot/version.py,sha256=4UuHbgyO35GNcD18udMY95wD3BPnaCXT_iZyOKKtuMw,1545
 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,7 +12,7 @@ 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=MvM1vVf5NlHaDc3rI6mQV_mjNxOaGVuBsGGRtLXSG3I,81909
@@ -20,9 +20,9 @@ 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=mTZ-c3k-adQKYxm2tMRnzuQNwFLTOHCYYhKGwe4kd3o,109473
+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=iTmR7DJL3iUDgHOikFRPkMRejmZrNaeX7BHpZqhI4aY,16991
 tecplot/data/variable.py,sha256=xJCOO5ZeXCAFWKJYnC_mMxWKoy-oe3pE0EnHytZOwro,9437
@@ -45,23 +45,23 @@ tecplot/legend/legend.py,sha256=FTx03o54awsytUUI2fu8db2oCWvG9L8_D6fymS-gd-Q,4022
 tecplot/legend/line_legend.py,sha256=qim_xoNHB7gk-Hn7x6d5Yttd_zfFAaoA2KKqpD0S94Q,2121
 tecplot/legend/rgb_coloring_legend.py,sha256=pDgPaQBtdV99Qz2tDkxc-FGXHmpBSfwZvtDrKXf3gus,9740
 tecplot/legend/scatter_legend.py,sha256=_td5uXO2u3PxT-cCYfGlMVZWHuA4k9i75YYzvLdHv6E,4013
-tecplot/plot/__init__.py,sha256=2fOlr0Xb48oHO5-OTioxN0yls-2LCPbptzuCusnag9c,3950
+tecplot/plot/__init__.py,sha256=kyez7N6l_bSdd3JodLS8BBxP9W_tfwCcuOBdYOjqxYo,3995
 tecplot/plot/axes.py,sha256=ix_rANTSZdMXWfrBDeR5Zq4AWkJ1hXkog1ply6oSbPI,26962
 tecplot/plot/axis.py,sha256=3cgOPbgQdCAWueqfjOpZUbPdhYLsw3bqw4Apm7vEaRQ,43264
 tecplot/plot/blanking.py,sha256=j7iwZsiN78DiFzExR83iLk8m6LPFWTQx2ev7s_On3d8,20237
 tecplot/plot/contour.py,sha256=tw-7YW27uwr-V17Ip5zvQtZXsbbG4ca-oILB2bCPu1k,44240
-tecplot/plot/effects.py,sha256=wsj0EhnXEQePq7SRxLogcUClDWNVFaFyUSf20yuKTF4,5691
-tecplot/plot/fieldmap.py,sha256=o5XjjUDcUK55dieSSWYv7NzzMN0kXArFV2UuP86AFzE,76312
+tecplot/plot/effects.py,sha256=z6wUe7XmumsQ-PlUtm1bOtKPoDpSUNuUTjy058XM11A,11169
+tecplot/plot/fieldmap.py,sha256=GcwxDN_TyBcdUquV3T5g0k1jXEeCkY3ZL16yGLgngCw,77023
 tecplot/plot/grid.py,sha256=p8h2Tmu93aVunOww6VXSuK8onjf1HkYZRQEyApTJr_c,22463
 tecplot/plot/hoe_settings.py,sha256=r_ZFwhWa0pes3bQwqcX6kpMWp7Q7_tLalCIHdIAUw8Y,1931
-tecplot/plot/isosurface.py,sha256=1QUCakVNMD2diThLnRJW7xsFfsy-RMLYmncGdv-P4Co,41154
+tecplot/plot/isosurface.py,sha256=Y8leSqYnqg-e_YHQ4ZMp4djOwZaLMfBJBE1QWBm13ms,41856
 tecplot/plot/labels.py,sha256=ac8Dl37lGbkY78cJJo_aCuN9zslYZthSZqriTHGkPOs,10578
 tecplot/plot/linemap.py,sha256=NHb83QTY1OzI2PO5D_HSlaAxuTrLJxH4fEpE-YQKPgY,63631
 tecplot/plot/linking.py,sha256=HyetVeDsnUsGJtmWLURg6ylyCom0zR-0UubrVynB_fs,16775
-tecplot/plot/plot.py,sha256=WB2S4cHc0JB2wQrZSoEISpjvuXuQRZ_QXLuFaBNJuhk,60658
+tecplot/plot/plot.py,sha256=AxerHBcbVdk_K8wMkEtQ3Yulfii6rXFHggpjDPiMauE,61751
 tecplot/plot/rgb_coloring.py,sha256=OfcIvhQ9Tm5TQylOUttX7QcNu3CHtETBpIz7gqa9GwY,9417
 tecplot/plot/scatter.py,sha256=_Z7Kte2XSruGcDxEDETD3-4-ynYPvc85_W5jNSzG9lE,12610
-tecplot/plot/slice.py,sha256=C2yUnta-ls0oN_7vM_qaXbZczFS4jWNsSypZX6CV3wk,53179
+tecplot/plot/slice.py,sha256=364P2jyWE-Qovgr6Lii_bU6G2fRNKhQH-NRBHryc5ZQ,53897
 tecplot/plot/streamtrace.py,sha256=6x6yJgMgmtUAGUjqqaWWyMvIPjbRdvKjkqE6LKbDf_o,65581
 tecplot/plot/symbol.py,sha256=6p28udpGG-rOKCAb9bgsk6kWHqXYPfAQ7W-jBrtmPaA,18422
 tecplot/plot/ticks.py,sha256=Wx3myMFWJYqeE8uefTv3sZYBBAAcaK2Pg6v-0pBk56M,19252
@@ -74,26 +74,26 @@ tecplot/session/config.py,sha256=UrKiaP1HIZSO1J-eV-SEPZa0LvxK80eDcQanEZNeMtw,295
 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
+tecplot/tecutil/__init__.py,sha256=5jki45DrpyEnes5lJr1lxIlfa17KEMX9yL7rvx8p7qc,783
 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=P1bwpHlwAtOLw4Kdz1zHipEjVTEtKIy0Nv_5b3nmLQA,21935
 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/sv.py,sha256=2fWRyOzIMCLYFT7e0uLHVPTHBo-yhJeOENxh15jwmKo,55091
+tecplot/tecutil/tecutil.py,sha256=1Gk0piCrUyhcEv04VQ0Pmw3YZxbAjg69gwQILYlFn_4,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/util.py,sha256=JgNpjE3J7Uz_QHqPrOxmHCwNnIojkZVfdKftVw_WUdo,12055
+tecplot/tecutil/tecutil_connector.py,sha256=GzmdZ2yBn6HFzD-qB1ICz-dduocFnjkV6mmBvkn5qtc,37148
+tecplot/tecutil/tecutil_rpc.py,sha256=bei8gcQPHRS1OgBZQdLSYdX6SF_M1WzAqhSp3kQK_sk,288068
+tecplot/tecutil/util.py,sha256=wtcK1_tO4_6pKBsqYopoM5RJl35kPcYFY23kvn1tJZU,12559
 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.4.dist-info/METADATA,sha256=kq8Y9ArAbkVPkrLVzXQyG9x7FLZXkqeBSrp6jOop6ks,23443
-pytecplot-1.7.4.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
-pytecplot-1.7.4.dist-info/top_level.txt,sha256=gU7HYnAb3AVBIKRUOASdYO0QRI6hg1raLt8aN5E4o7s,8
-pytecplot-1.7.4.dist-info/RECORD,,
+pytecplot-1.8.0.dist-info/METADATA,sha256=gvwJlY-I2CjNQUlcF9QNlfRYtUTfM2tWUjJ8UmOTods,24173
+pytecplot-1.8.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+pytecplot-1.8.0.dist-info/top_level.txt,sha256=gU7HYnAb3AVBIKRUOASdYO0QRI6hg1raLt8aN5E4o7s,8
+pytecplot-1.8.0.dist-info/RECORD,,

{pytecplot-1.7.4.dist-info → pytecplot-1.8.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (82.0.0)
+Generator: setuptools (84.2.1)
 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/load.py

@@ -996,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,

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/plot/__init__.py

@@ -11,7 +11,7 @@ from .blanking import IJKBlanking
 from .contour import (ContourGroup, ContourColorCutoff, ContourColormapFilter,
                       ContourColormapOverride, ContourColormapZebraShade,
                       ContourLabels, ContourLevels, ContourLines)
-from .effects import LightSource
+from .effects import LightSource, LineIntegralConvolution, SurfaceFlowEffects
 from .fieldmap import (FieldmapContour, FieldmapEdge, FieldmapEffects,
                        FieldmapEffects3D, Fieldmap, Cartesian2DFieldmap,
                        Cartesian2DFieldmapCollection, Cartesian3DFieldmap,

tecplot/plot/effects.py

@@ -1,7 +1,182 @@
 from builtins import super
 
 from ..tecutil import sv
+from ..constant import *
 from .. import session, tecutil, version
+from ..exception import *
+from ..tecutil import _require_surface_flow_effects_sdk
+
+
+class SurfaceFlowEffects(session.Style):
+    """Shared surface-flow effect settings for field-plot surfaces.
+
+    .. versionadded:: 1.7, Tecplot 360 2026.1
+        Surface-flow effects require Tecplot 360 2026 R1 or later.
+    """
+
+    def __init__(self, plot):
+        _require_surface_flow_effects_sdk()
+        self.plot = plot
+        super().__init__(sv.GLOBALSURFACEFLOWEFFECTS,
+                         uniqueid=self.plot.frame.uid)
+
+    @property
+    def line_integral_convolution(self):
+        """`LineIntegralConvolution`: Line integral convolution parameter settings.
+
+        Example usage::
+
+            >>> lic = plot.surface_flow_effects.line_integral_convolution
+            >>> lic.step_size = 0.9
+        """
+        return LineIntegralConvolution(self)
+
+
+class LineIntegralConvolution(session.Style):
+    """Shared line integral convolution settings for field-plot surfaces.
+
+    .. versionadded:: 1.7, Tecplot 360 2026.1
+        Line integral convolution requires Tecplot 360 2026 R1 or later.
+
+    .. code-block:: python
+        :emphasize-lines: 18-24
+
+        import os
+        import tecplot
+        from tecplot.constant import *
+
+        examples_dir = tecplot.session.tecplot_examples_directory()
+        datafile = os.path.join(examples_dir, 'SimpleData', 'VortexShedding.plt')
+        dataset = tecplot.data.load_tecplot(datafile)
+        frame = dataset.frame
+        frame.plot_type = PlotType.Cartesian2D
+
+        plot = frame.plot()
+
+        plot.axes.x_axis.min = -0.004
+        plot.axes.x_axis.max = 0.004
+        plot.axes.y_axis.min = -0.004
+        plot.axes.y_axis.max = 0.004
+
+        plot.use_surface_flow_effect = True
+
+        fmap = plot.fieldmap(1)
+        fmap.effects.surface_flow_effect = SurfaceFlowEffect.LIC
+
+        lic = plot.surface_flow_effects.line_integral_convolution
+        lic.intensity = 0.95
+
+        tecplot.export.save_png('line_integral_convolution.png')
+
+    ..  figure:: /_static/images/line_integral_convolution.png
+        :width: 300px
+        :figwidth: 300px
+    """
+
+    def __init__(self, surface_flow_effects):
+        self.surface_flow_effects = surface_flow_effects
+        self.plot = surface_flow_effects.plot
+        super().__init__(surface_flow_effects._sv, sv.LINEINTEGRALCONVOLUTION,
+                         **surface_flow_effects._kw)
+
+    @property
+    def step_size(self):
+        """`float`: Convolution step size."""
+        return self._get_style(float, sv.STEPSIZE)
+
+    @step_size.setter
+    def step_size(self, value):
+        self._set_style(float(value), sv.STEPSIZE)
+
+    @property
+    def num_steps(self):
+        """`int`: Number of convolution steps."""
+        return self._get_style(int, sv.NUMSTEPS)
+
+    @num_steps.setter
+    def num_steps(self, value):
+        self._set_style(int(value), sv.NUMSTEPS)
+
+    @property
+    def intensity(self):
+        """`float`: Line integral convolution intensity."""
+        return self._get_style(float, sv.INTENSITY)
+
+    @intensity.setter
+    def intensity(self, value):
+        self._set_style(float(value), sv.INTENSITY)
+
+    @property
+    def smoothing(self):
+        """`int`: Smoothing pass count."""
+        return self._get_style(int, sv.SMOOTHING)
+
+    @smoothing.setter
+    def smoothing(self, value):
+        self._set_style(int(value), sv.SMOOTHING)
+
+    @property
+    def contrast_boost(self):
+        """`float`: Line integral convolution contrast boost amount."""
+        return self._get_style(float, sv.CONTRASTBOOST)
+
+    @contrast_boost.setter
+    def contrast_boost(self, value):
+        self._set_style(float(value), sv.CONTRASTBOOST)
+
+    @property
+    def shading(self):
+        """`float`: Line integral convolution surface shading amount."""
+        return self._get_style(float, sv.SHADING)
+
+    @shading.setter
+    def shading(self, value):
+        self._set_style(float(value), sv.SHADING)
+
+    @property
+    def color_mode(self):
+        """`LICColorMode`: Line integral convolution compositing mode."""
+        return self._get_style(LICColorMode, sv.COLORMODE)
+
+    @color_mode.setter
+    def color_mode(self, value):
+        self._set_style(LICColorMode(value), sv.COLORMODE)
+
+    @property
+    def mask_threshold(self):
+        """`float`: Line integral convolution mask threshold."""
+        return self._get_style(float, sv.LICMASKTHRESHOLD)
+
+    @mask_threshold.setter
+    def mask_threshold(self, value):
+        self._set_style(float(value), sv.LICMASKTHRESHOLD)
+
+    @property
+    def mask_fade_size(self):
+        """`float`: Line integral convolution mask fade size."""
+        return self._get_style(float, sv.LICMASKFADESIZE)
+
+    @mask_fade_size.setter
+    def mask_fade_size(self, value):
+        self._set_style(float(value), sv.LICMASKFADESIZE)
+
+    @property
+    def use_mask_threshold(self):
+        """`bool`: Enable the Line integral convolution mask threshold."""
+        return self._get_style(bool, sv.USELICMASKTHRESHOLD)
+
+    @use_mask_threshold.setter
+    def use_mask_threshold(self, value):
+        self._set_style(bool(value), sv.USELICMASKTHRESHOLD)
+
+    @property
+    def overlay_color(self):
+        """`Color`: Line integral convolution overlay color used when color mode is Overlay."""
+        return self._get_style(Color, sv.OVERLAYCOLOR)
+
+    @overlay_color.setter
+    def overlay_color(self, value):
+        self._set_style(Color(value), sv.OVERLAYCOLOR)
 
 
 class LightSource(session.Style):

tecplot/plot/fieldmap.py

@@ -11,7 +11,8 @@ from textwrap import dedent
 from ..tecutil import _tecutil
 from ..constant import *
 from ..exception import *
-from ..tecutil import Index, IndexSet, color_spec, flatten_args, sv
+from ..tecutil import (Index, IndexSet, _require_surface_flow_effects_sdk,
+                       color_spec, flatten_args, sv)
 from .. import session, tecutil
 from . import symbol
 
@@ -1587,10 +1588,10 @@ class Fieldmap(FieldmapCollection):
 
 
 class FieldmapEffects(session.SubStyle):
-    """Clipping and blanking style control.
+    """Clipping, blanking, and surface-flow style control.
 
-    This object controls value blanking and clipping from plane slices for
-    this fieldmap.
+    This object controls value blanking, clipping from plane slices, and
+    the ``surface_flow_effect`` setting for this fieldmap.
     """
     def __init__(self, fieldmap):
         self.fieldmap = fieldmap
@@ -1610,6 +1611,21 @@ class FieldmapEffects(session.SubStyle):
     def value_blanking(self, value):
         self._set_style(bool(value), sv.USEVALUEBLANKING)
 
+    @property
+    def surface_flow_effect(self):
+        """`SurfaceFlowEffect`: Surface-flow effect for this fieldmap.
+
+        .. versionadded:: 1.7, Tecplot 360 2026.1
+            Surface-flow effects require Tecplot 360 2026 R1 or later.
+        """
+        _require_surface_flow_effects_sdk()
+        return self._get_style(SurfaceFlowEffect, sv.SURFACEFLOWEFFECT)
+
+    @surface_flow_effect.setter
+    def surface_flow_effect(self, value):
+        _require_surface_flow_effects_sdk()
+        self._set_style(SurfaceFlowEffect(value), sv.SURFACEFLOWEFFECT)
+
     @property
     def clip_planes(self):
         tecutil.api_moved('FieldmapEffects.clip_planes',
@@ -1626,7 +1642,7 @@ class FieldmapEffects(session.SubStyle):
 
 
 class FieldmapEffects3D(FieldmapEffects):
-    """Lighting and translucency style control.
+    """Lighting, translucency and surface-flow style control.
 
     .. code-block:: python
         :emphasize-lines: 24-26
@@ -1958,7 +1974,7 @@ class Cartesian2DFieldmapCollection(FieldmapCollection):
 
     @property
     def effects(self):
-        """`FieldmapEffects`: Style control for clipping and blanking effects.
+        """`FieldmapEffects`: Style control for clipping, blanking, and surface-flow effects.
         """
         return FieldmapEffects(self)
 
@@ -2091,7 +2107,7 @@ class Cartesian3DFieldmapCollection(FieldmapCollection):
 
     @property
     def effects(self):
-        """`FieldmapEffects3D`: Style control for blanking and lighting effects.
+        """`FieldmapEffects3D`: Style control for surface-flow, blanking, and lighting.
         """
         return FieldmapEffects3D(self)
 

tecplot/plot/isosurface.py

@@ -5,8 +5,8 @@ from collections.abc import Iterable
 from ..tecutil import _tecutil
 from ..constant import *
 from ..exception import *
-from .. import session, tecutil, version
-from ..tecutil import Index, sv, color_spec
+from .. import session, tecutil
+from ..tecutil import Index, _require_surface_flow_effects_sdk, color_spec, sv
 
 
 class IsosurfaceGroupStyle(session.Style):
@@ -362,7 +362,7 @@ class IsosurfaceContour(IsosurfaceGroupStyle):
 
 
 class IsosurfaceEffects(IsosurfaceGroupStyle):
-    """Effects of the isosurface group.
+    """Effects of the isosurface group, including surface-flow effects.
 
     .. code-block:: python
         :emphasize-lines: 21-23
@@ -451,6 +451,21 @@ class IsosurfaceEffects(IsosurfaceGroupStyle):
     def lighting_effect(self, value):
         self._set_style(LightingEffect(value), sv.LIGHTINGEFFECT)
 
+    @property
+    def surface_flow_effect(self):
+        """`SurfaceFlowEffect`: Surface-flow mode for this isosurface group.
+
+        .. versionadded:: 1.7, Tecplot 360 2026.1
+            Surface-flow effects require Tecplot 360 2026 R1 or later.
+        """
+        _require_surface_flow_effects_sdk()
+        return self._get_style(SurfaceFlowEffect, sv.SURFACEFLOWEFFECT)
+
+    @surface_flow_effect.setter
+    def surface_flow_effect(self, value):
+        _require_surface_flow_effects_sdk()
+        self._set_style(SurfaceFlowEffect(value), sv.SURFACEFLOWEFFECT)
+
     @property
     def surface_translucency(self):
         """`int`: Surface translucency of the isosurface group.
@@ -733,6 +748,8 @@ class IsosurfaceGroup(session.Style):
     def effects(self):
         """`IsosurfaceEffects`: Settings for isosurface effects.
 
+        This includes ``surface_flow_effect``, translucency, and lighting.
+
         Example usage::
 
             >>> plot.isosurface(0).show = True

tecplot/plot/plot.py

@@ -341,6 +341,39 @@ class FieldPlot(Plot):
             session.set_style(bool(show), sv.STREAMTRACELAYERS, sv.SHOW,
                               uniqueid=self.frame.uid)
 
+    @property
+    def use_surface_flow_effect(self):
+        """`bool`: Enable field-layer surface-flow rendering for this frame.
+
+        Example usage::
+
+            >>> plot.use_surface_flow_effect = True
+
+        .. versionadded:: 1.7, Tecplot 360 2026.1
+            Surface-flow effects require Tecplot 360 2026 R1 or later.
+        """
+        tecutil._require_surface_flow_effects_sdk()
+        return self._get_style(bool, sv.USESURFACEFLOWEFFECT)
+
+    @use_surface_flow_effect.setter
+    def use_surface_flow_effect(self, value):
+        tecutil._require_surface_flow_effects_sdk()
+        self._set_style(bool(value), sv.USESURFACEFLOWEFFECT)
+
+    @property
+    def surface_flow_effects(self):
+        """`SurfaceFlowEffects`: Shared surface-flow effect settings.
+
+        Example usage::
+
+            >>> lic = plot.surface_flow_effects.line_integral_convolution
+            >>> lic.step_size = 0.9
+
+        .. versionadded:: 1.7, Tecplot 360 2026.1
+            Surface-flow effects require Tecplot 360 2026 R1 or later.
+        """
+        return effects.SurfaceFlowEffects(self)
+
     @property
     def show_vector(self):
         """`bool`: Enable drawing of vectors.