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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytecplot
-Version: 1.7.2
+Version: 1.7.3
 Summary: A Python interface to Tecplot 360
 Author-email: "Tecplot, Inc." <support@tecplot.com>
 License-Expression: LicenseRef-Tecplot-Software-License
@@ -107,6 +107,18 @@ 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.3
+^^^^^^^^^^^^^^^
+
+* Updated enums to reflect new changes in Tecplot 360 2025 R2:
+    * `tecplot.constant.LightingEffect.Gouraud` has been deprecated. Scripts should now
+      use `LightingEffect.Smooth` or `LightingEffect.SmoothWithCreases`.
+    * `tecplot.constant.SphereScatterRenderQuality.Fast` is now default and should be
+      favored over all other options.
+* Deprecated `LightSource.force_gouraud_for_contour_flood`. Use the `LightingEffect`
+  enum to set the lighting effects directly on the individual fieldmaps, slices,
+  isosurfaces, or streamtraces as desired.
+
 PyTecplot 1.7.2
 ^^^^^^^^^^^^^^^
 

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

@@ -1,9 +1,9 @@
-pytecplot-1.7.2.dist-info/licenses/LICENSE.html,sha256=I240fAHgxqlSQn_eSmb9ktcS4hgugObDnHYQnlEPzt8,28492
+pytecplot-1.7.3.dist-info/licenses/LICENSE.html,sha256=I240fAHgxqlSQn_eSmb9ktcS4hgugObDnHYQnlEPzt8,28492
 tecplot/__init__.py,sha256=iHAPbGDgIh7HtLWaWcDYfVS4TOsNrRSHyQa-H_6Li3g,3550
-tecplot/constant.py,sha256=_Ws6ldiZAkkOJjGWM9PEAMR0mHZ49qcYjJVpK51E99o,8531
+tecplot/constant.py,sha256=DJ641ugRqAQNd8uQITFbhbyEK3JwR9QhfG_CteUn5s4,8686
 tecplot/exception.py,sha256=YB4zeL0-07yCy4pyUqeFdNQ98nK11h2n3ZHHe58Od6s,6493
 tecplot/macro.py,sha256=uE29ftjdr2HdlFVa9SS-1uBU8Di4W3PwquhI75LnvhM,13307
-tecplot/version.py,sha256=COK9w92DuNTvr-nKW3kwRSetDsIWyvA9iJisXXYBVuQ,1544
+tecplot/version.py,sha256=dJQPI9B2wTzxrQjUGKCiAvoBwhA3Mz4v4bH5Hz31OSQ,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
@@ -50,19 +50,19 @@ 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=Q9KytPL9dzanSG2Wbx09lNjf1OeKep5Aj3gyOv9s0JE,4983
-tecplot/plot/fieldmap.py,sha256=Ysih0sWQmeTTpREV2-4Wh5-XDPkTetOD_UG7XPle0Ws,75630
+tecplot/plot/effects.py,sha256=wsj0EhnXEQePq7SRxLogcUClDWNVFaFyUSf20yuKTF4,5691
+tecplot/plot/fieldmap.py,sha256=o5XjjUDcUK55dieSSWYv7NzzMN0kXArFV2UuP86AFzE,76312
 tecplot/plot/grid.py,sha256=p8h2Tmu93aVunOww6VXSuK8onjf1HkYZRQEyApTJr_c,22463
 tecplot/plot/hoe_settings.py,sha256=r_ZFwhWa0pes3bQwqcX6kpMWp7Q7_tLalCIHdIAUw8Y,1931
-tecplot/plot/isosurface.py,sha256=WQec-6hIur5Eyi9Z7m_Y4nuFmGGLUF2RQZDzZRXT1o4,40303
+tecplot/plot/isosurface.py,sha256=1QUCakVNMD2diThLnRJW7xsFfsy-RMLYmncGdv-P4Co,41154
 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/rgb_coloring.py,sha256=OfcIvhQ9Tm5TQylOUttX7QcNu3CHtETBpIz7gqa9GwY,9417
-tecplot/plot/scatter.py,sha256=SFjxZThZFbJwx0q-McjvSekQ8EdepMtLVurCFo_dKZk,12609
-tecplot/plot/slice.py,sha256=hebSpbQYdgjmIJkI-1mUzI4Ud6eahKPiaC3ooWke9SE,52285
-tecplot/plot/streamtrace.py,sha256=kL_3SFhYnmEIdLX2OmcP4tcxysdG41e2LZ4URZEshIA,64686
+tecplot/plot/scatter.py,sha256=_Z7Kte2XSruGcDxEDETD3-4-ynYPvc85_W5jNSzG9lE,12610
+tecplot/plot/slice.py,sha256=C2yUnta-ls0oN_7vM_qaXbZczFS4jWNsSypZX6CV3wk,53179
+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
 tecplot/plot/title.py,sha256=Eg4T5i_Z_thuISW8CJi0gh_tGwfQ84zD6J0VZcaUnP8,11162
@@ -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=EDZ2XQu0L_0wTVjiI6OxMVdX8SVh_nk_jklq58CmzeQ,19174
+tecplot/tecutil/constant.py,sha256=XeUIJRNVhQ6yQHPkpztnkAJQu-GytGG90FMXjZepKgk,19402
 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=8EUln_hn7c2FZ3QMiK9zWMSxAQdhbKmKlTLvU-9lZ-4,54100
-tecplot/tecutil/tecutil.py,sha256=Zmz8LvQ3l25QAbIZgMjZQQHgnA-r6lgYu5n-lYwNMeo,691565
+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/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/tecutil/tecutil_rpc.py,sha256=ypGDA5ktXNClT9trdK1ElGnhrsO-oTABncT2CdQkRDU,287428
+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.2.dist-info/METADATA,sha256=hslYbIzWTy6Hp4Qdj06IgPBR7nwMEH_0xjfvV2aptuo,22461
-pytecplot-1.7.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pytecplot-1.7.2.dist-info/top_level.txt,sha256=gU7HYnAb3AVBIKRUOASdYO0QRI6hg1raLt8aN5E4o7s,8
-pytecplot-1.7.2.dist-info/RECORD,,
+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,,

tecplot/constant.py

@@ -193,6 +193,16 @@ class AuxDataObjectType(_Enum):
     Zone = 6
 
 
+_LightingEffect = LightingEffect
+
+
+class LightingEffect(_Enum):
+  Paneled = _LightingEffect.Paneled.value
+  SmoothWithCreases = _LightingEffect.SmoothWithCreases.value
+  Smooth = _LightingEffect.Smooth.value
+  Gouraud = SmoothWithCreases
+
+
 class SymbolType(_Enum):
     Text = 0
     Geometry = 1
@@ -231,7 +241,6 @@ assert len(StepMode) == len(SkipMode), 'tecplot/constant.py requires update'
 
 _FunctionDependency = FunctionDependency
 
-
 class FunctionDependency(_Enum):
     XIndependent = _FunctionDependency.XIndependent.value
     YIndependent = _FunctionDependency.YIndependent.value
@@ -293,13 +302,6 @@ class SliceSurface(_Enum):
     Arbitrary = 7
 
 
-class SphereScatterRenderQuality(_Enum):
-    Low = 0
-    Medium = 1
-    High = 2
-
-
-
 class TecUtilServerProcessingMode(_Enum):
     Unspecified = 0
     Single = 1

tecplot/plot/effects.py

@@ -1,7 +1,7 @@
 from builtins import super
 
 from ..tecutil import sv
-from .. import session
+from .. import session, tecutil, version
 
 
 class LightSource(session.Style):
@@ -135,17 +135,25 @@ class LightSource(session.Style):
 
     @property
     def force_gouraud_for_contour_flood(self):
-        """`bool`: Force gouraud effects for shaded continuous flooding.
-
-        Example usage::
-
-            >>> plot.light_source.force_gouraud_for_contour_flood = True
-        """
-        return self._get_style(bool, sv.FORCEGOURAUDFOR3DCONTFLOOD)
+        if version.sdk_version_info < (2025, 2):
+            return self._get_style(bool, sv.FORCEGOURAUDFOR3DCONTFLOOD)
+        else:
+            tecutil.api_changed('''\
+                LightSource.force_gouraud_for_contour_flood property has been removed.
+                Set the lighting_effect property to LightingEffect.SmoothWithCreases
+                on fieldmap.effects, isosurface.effects, slice.effects, or
+                streamtrace.effects as desired.''', '1.7.3', '2025 R2', warning=True)
 
     @force_gouraud_for_contour_flood.setter
     def force_gouraud_for_contour_flood(self, value):
-        self._set_style(bool(value), sv.FORCEGOURAUDFOR3DCONTFLOOD)
+        if version.sdk_version_info < (2025, 2):
+            self._set_style(bool(value), sv.FORCEGOURAUDFOR3DCONTFLOOD)
+        else:
+            tecutil.api_changed('''\
+                LightSource.force_gouraud_for_contour_flood property has been removed.
+                Set the lighting_effect property to LightingEffect.SmoothWithCreases
+                on fieldmap.effects, isosurface.effects, slice.effects, or
+                streamtrace.effects as desired.''', '1.7.3', '2025 R2', warning=True)
 
     @property
     def force_paneled_for_cell_flood(self):

tecplot/plot/fieldmap.py

@@ -1681,15 +1681,24 @@ class FieldmapEffects3D(FieldmapEffects):
             This shade is based on the orientation of the cell relative to your
             3D light source.
 
-        `Gouraud <LightingEffect.Gouraud>`
-            This plot type offers smoother, more continuous shading than
-            `Paneled <LightingEffect.Paneled>` shading, but it results in
-            slower plotting and larger vector images. `Gouraud
-            <LightingEffect.Gouraud>` shading is not continuous across zone
-            boundaries unless face neighbors are specified in the data and is
-            not available for finite element volume zones when blanking is
-            active in which case, the zone's lighting effect reverts to
-            `Paneled <LightingEffect.Paneled>` shading in this case.
+        `Smooth <LightingEffect.Smooth>`
+            Unlike `Paneled <LightingEffect.Paneled>` shading that colors the cell
+            surface considering a constant angle to the light relative to the cell's
+            surface normal, `Smooth <LightingEffect.Smooth>` computes the average normal
+            around each cell node and interpolates the lighting influence smoothly
+            across the cell face. `SmoothWithCreases <LightingEffect.SmoothWithCreases>`
+            shading is not continuous across zone boundaries unless face neighbors are
+            specified in the data.
+
+        `SmoothWithCreases <LightingEffect.SmoothWithCreases>`
+            This option is similar to `Smooth <LightingEffect.Smooth>` but considers the
+            crease angle between neighboring, connected cell faces. When the crease
+            angle exceeds the specified amount the edge is considered creased and the
+            lighting interpolation across the cell uses the cell's surface normal for
+            the shared nodes along that edge instead of the average surface normal at
+            those nodes. If the surface has many edges that exceed the crease angle,
+            such as a very chaotic iso-surface, a significantly larger amount of data is
+            required to render the surface.
 
         If ``IJK``-ordered data with `FieldmapSurfaces.surfaces_to_plot` is set
         to `SurfacesToPlot.ExposedCellFaces`, faces exposed by blanking will

tecplot/plot/isosurface.py

@@ -414,20 +414,31 @@ class IsosurfaceEffects(IsosurfaceGroupStyle):
         Isosurface lighting effects must be enabled by setting
         `IsosurfaceShade.use_lighting_effect` to `True` when setting this value.
 
-        There are two types of lighting effects: Paneled and Gouraud:
+        There are three types of lighting effects: Paneled, SmoothWithCreases and
+        Smooth:
 
             * `Paneled`: Within each cell, the color assigned to each area by
                 shading or contour flooding is tinted by a shade constant
                 across the cell. This shade is based on the orientation
                 of the cell relative to your 3D light source.
-            * `Gouraud`: This offers smoother, more continuous shading than
-                Paneled shading, but it also results in slower plotting
-                and larger print files. `Gouraud` shading is not continuous
-                across zone boundaries unless face neighbors are specified
-                in the data. `Gouraud` shading is not available for finite
-                element volume `Zone <data_access>` when blanking is active.
-                The zone's lighting effect reverts to `Paneled`
-                shading in this case.
+            * `Smooth <LightingEffect.Smooth>`
+                Unlike `Paneled <LightingEffect.Paneled>` shading that colors the cell
+                surface considering a constant angle to the light relative to the cell's
+                surface normal, `Smooth <LightingEffect.Smooth>` computes the average
+                normal around each cell node and interpolates the lighting influence
+                smoothly across the cell face. `SmoothWithCreases
+                <LightingEffect.SmoothWithCreases>` shading is not continuous across
+                zone boundaries unless face neighbors are specified in the data.
+            * `SmoothWithCreases <LightingEffect.SmoothWithCreases>`
+                This option is similar to `Smooth <LightingEffect.Smooth>` but considers
+                the crease angle between neighboring, connected cell faces. When the
+                crease angle exceeds the specified amount the edge is considered creased
+                and the lighting interpolation across the cell uses the cell's surface
+                normal for the shared nodes along that edge instead of the average
+                surface normal at those nodes. If the surface has many edges that exceed
+                the crease angle, such as a very chaotic iso-surface, a significantly
+                larger amount of data is required to render the surface.
+
 
         Example usage::
 
@@ -447,7 +458,6 @@ class IsosurfaceEffects(IsosurfaceGroupStyle):
         Iso-surface surface translucency must be enabled by setting
         `IsosurfaceEffects.use_translucency` = `True` when setting this value.
 
-
         Valid translucency values range from one (opaque) to 99 (translucent).
 
         Example usage::

tecplot/plot/scatter.py

@@ -346,7 +346,7 @@ class Scatter(session.Style):
             >>> from tecplot.constant import *
             >>> plot.fieldmap(0).scatter.symbol().shape = GeomShape.Sphere
             >>> scatter = plot.scatter
-            >>> scatter.sphere_render_quality = SphereScatterRenderQuality.Low
+            >>> scatter.sphere_render_quality = SphereScatterRenderQuality.Fast
         """
         return self._get_style(SphereScatterRenderQuality,
                                sv.SPHERESCATTERRENDERQUALITY)

tecplot/plot/slice.py

@@ -226,20 +226,30 @@ class SliceEffects(session.SubStyle):
         `SliceContour.use_lighting_effect` or
         `SliceShade.use_lighting_effect` to `True` when setting this value.
 
-        There are two types of lighting effects: Paneled and Gouraud:
+        There are three types of lighting effects: Paneled, SmoothWithCreases and
+        Smooth:
 
             * `Paneled`: Within each cell, the color assigned to each area by
                 shading or contour flooding is tinted by a shade constant
                 across the cell. This shade is based on the orientation
                 of the cell relative to your 3D light source.
-            * `Gouraud`: This offers smoother, more continuous shading than
-                Paneled shading, but it also results in slower plotting and
-                larger print files. `Gouraud` shading is not continuous across
-                zone boundaries unless face neighbors are specified in the
-                data. `Gouraud` shading is not available for finite element
-                volume `Zones <data_access>` when blanking is active. The
-                zone's lighting effect reverts to `Paneled` shading in this
-                case.
+            * `Smooth <LightingEffect.Smooth>`
+                Unlike `Paneled <LightingEffect.Paneled>` shading that colors the cell
+                surface considering a constant angle to the light relative to the cell's
+                surface normal, `Smooth <LightingEffect.Smooth>` computes the average
+                normal around each cell node and interpolates the lighting influence
+                smoothly across the cell face. `SmoothWithCreases
+                <LightingEffect.SmoothWithCreases>` shading is not continuous across
+                zone boundaries unless face neighbors are specified in the data.
+            * `SmoothWithCreases <LightingEffect.SmoothWithCreases>`
+                This option is similar to `Smooth <LightingEffect.Smooth>` but considers
+                the crease angle between neighboring, connected cell faces. When the
+                crease angle exceeds the specified amount the edge is considered creased
+                and the lighting interpolation across the cell uses the cell's surface
+                normal for the shared nodes along that edge instead of the average
+                surface normal at those nodes. If the surface has many edges that exceed
+                the crease angle, such as a very chaotic iso-surface, a significantly
+                larger amount of data is required to render the surface.
 
         Example usage::
 
@@ -754,8 +764,9 @@ class SliceContour(session.SubStyle):
             the same value for `SliceShade.use_lighting_effect`,
             and vice-versa.
 
-        The lighting effect is set with `SliceEffects.lighting_effect`, and may
-        be one of `LightingEffect.Gouraud` or `LightingEffect.Paneled`.
+        The lighting effect is set with `SliceEffects.lighting_effect`, and may be one
+        of `LightingEffect.SmoothWithCreases`, `LightingEffect.Smooth`, or
+        `LightingEffect.Paneled`.
 
         Example usage::
 

tecplot/plot/streamtrace.py

@@ -571,8 +571,9 @@ class StreamtraceRodRibbonContour(StreamtraceStyle):
             the same value for `StreamtraceRodRibbonShade.use_lighting_effect`,
             and vice-versa.
 
-        The lighting effect is set with `StreamtraceRodRibbonEffects.lighting_effect`, and may
-        be one of `LightingEffect.Gouraud` or `LightingEffect.Paneled`.
+        The lighting effect is set with `StreamtraceRodRibbonEffects.lighting_effect`,
+        and may be one of `LightingEffect.SmoothWithCreases`, `LightingEffect.Smooth`,
+        or `LightingEffect.Paneled`.
 
         Example usage::
 
@@ -809,20 +810,30 @@ class StreamtraceRodRibbonEffects(StreamtraceStyle):
         Note that setting `StreamtraceRodRibbonShade.use_lighting_effect` will also set
         this value for `ribbon contours <StreamtraceRodRibbonContour>`.
 
-        There are two types of lighting effects: Paneled and Gouraud:
+        There are three types of lighting effects: Paneled, SmoothWithCreases and
+        Smooth:
 
             * `Paneled`: Within each cell, the color assigned to each area by
                 shading or contour flooding is tinted by a shade constant
                 across the cell. This shade is based on the orientation
                 of the cell relative to your 3D light source.
-            * `Gouraud`: This offers smoother, more continuous shading than
-                Paneled shading, but it also results in slower plotting
-                and larger print files. `Gouraud` shading is not continuous
-                across zone boundaries unless face neighbors are specified
-                in the data. `Gouraud` shading is not available for finite
-                element volume `Zone <data_access>` when blanking is active.
-                The zone's lighting effect reverts to `Paneled`
-                shading in this case.
+            * `Smooth <LightingEffect.Smooth>`
+                Unlike `Paneled <LightingEffect.Paneled>` shading that colors the cell
+                surface considering a constant angle to the light relative to the cell's
+                surface normal, `Smooth <LightingEffect.Smooth>` computes the average
+                normal around each cell node and interpolates the lighting influence
+                smoothly across the cell face. `SmoothWithCreases
+                <LightingEffect.SmoothWithCreases>` shading is not continuous across
+                zone boundaries unless face neighbors are specified in the data.
+            * `SmoothWithCreases <LightingEffect.SmoothWithCreases>`
+                This option is similar to `Smooth <LightingEffect.Smooth>` but considers
+                the crease angle between neighboring, connected cell faces. When the
+                crease angle exceeds the specified amount the edge is considered creased
+                and the lighting interpolation across the cell uses the cell's surface
+                normal for the shared nodes along that edge instead of the average
+                surface normal at those nodes. If the surface has many edges that exceed
+                the crease angle, such as a very chaotic iso-surface, a significantly
+                larger amount of data is required to render the surface.
 
         Example usage::
 

tecplot/tecutil/constant.py

@@ -1,5 +1,5 @@
 #
-# This file was auto-generated on 2024-05-28 by tecgen.
+# This file was auto-generated on 2025-12-15 by tecgen.
 # IMPORTANT: DO NOT edit this file!
 #
 from enum import Enum as _Enum
@@ -407,7 +407,6 @@ class ExportFormat(_Enum):
   Custom = 15
   JPEG = 16
   Flash = 17
-  X3D = 18
   TecplotViewer = 19
   FLV = 20
   MPEG4 = 21
@@ -441,6 +440,10 @@ class FECellShape(_Enum):
   Pyramid = 5
   Prism = 6
 
+class FEDerivativeMethod(_Enum):
+  GreenGauss = 0
+  MovingLeastSquares = 1
+
 class FaceNeighborMode(_Enum):
   LocalOneToOne = 0
   LocalOneToMany = 1
@@ -558,6 +561,7 @@ class GeomShape(_Enum):
   Point = 10
   PieChart = 11
   LineArt = 12
+  Plus = 13
 
 class GetValueReturnCode(_Enum):
   Ok = 0
@@ -642,7 +646,8 @@ class LegendShow(_Enum):
 
 class LightingEffect(_Enum):
   Paneled = 0
-  Gouraud = 1
+  SmoothWithCreases = 1
+  Smooth = 3
 
 class LineCap(_Enum):
   Flat = 0
@@ -789,7 +794,6 @@ class PrinterDriver(_Enum):
   EPS = 4
   WINDOWS = 5
   WMF = 6
-  X3D = 7
 
 class ProbeNearest(_Enum):
   Position = 0
@@ -834,6 +838,10 @@ class RelOp(_Enum):
   EqualTo = 4
   NotEqualTo = 5
 
+class RenderAPI(_Enum):
+  OpenGL = 0
+  Vulkan = 1
+
 class Resulting1DZoneType(_Enum):
   IOrderedIfPossible = 0
   FELineSegment = 1
@@ -895,6 +903,12 @@ class SliceSource(_Enum):
   SurfacesOfVolumeZones = 2
   LinearZones = 3
 
+class SphereScatterRenderQuality(_Enum):
+  Low = 0
+  Medium = 1
+  High = 2
+  Fast = 3
+
 class StateChange(_Enum):
   VarsAltered = 0
   VarsAdded = 1

tecplot/tecutil/sv.py

@@ -1,5 +1,5 @@
 #
-# This file was auto-generated on 2024-05-28 by tecgen.
+# This file was auto-generated on 2025-12-15 by tecgen.
 # IMPORTANT: DO NOT edit this file!
 #
 
@@ -351,6 +351,7 @@ DEFINITIONCONTOURGROUP = 'DEFINITIONCONTOURGROUP'
 DEFNUMLEVELS = 'DEFNUMLEVELS'
 DELETEVARIABLESDIALOG = 'DELETEVARIABLESDIALOG'
 DELETEZONESDIALOG = 'DELETEZONESDIALOG'
+DELIVERNORMALSFORPANELSHADING = 'DELIVERNORMALSFORPANELSHADING'
 DELTATIME = 'DELTATIME'
 DEPENDENTVARS = 'DEPENDENTVARS'
 DEPTH = 'DEPTH'
@@ -410,6 +411,7 @@ ENABLEDELAYS = 'ENABLEDELAYS'
 ENABLEERRORS = 'ENABLEERRORS'
 ENABLEINTERRUPTS = 'ENABLEINTERRUPTS'
 ENABLEPAUSES = 'ENABLEPAUSES'
+ENABLERENDERSTATSOVERLAY = 'ENABLERENDERSTATSOVERLAY'
 ENABLEWARNINGS = 'ENABLEWARNINGS'
 END = 'END'
 ENDLEVEL = 'ENDLEVEL'
@@ -463,6 +465,7 @@ FACENODECOUNTS = 'FACENODECOUNTS'
 FACENODES = 'FACENODES'
 FACERIGHTELEMS = 'FACERIGHTELEMS'
 FASTLINEPATTERNSONSCREEN = 'FASTLINEPATTERNSONSCREEN'
+FEDERIVATIVEMETHOD = 'FEDERIVATIVEMETHOD'
 FFMPEGQSCALE = 'FFMPEGQSCALE'
 FIELD = 'FIELD'
 FIELDLAYERCONTROL = 'FIELDLAYERCONTROL'
@@ -514,6 +517,7 @@ FORMATTING = 'FORMATTING'
 FOURIERTRANSFORMDIALOG = 'FOURIERTRANSFORMDIALOG'
 FOURIERTRANSFORMRESULTINGVARS = 'FOURIERTRANSFORMRESULTINGVARS'
 FOURIERTRANSFORMRESULTINGZONES = 'FOURIERTRANSFORMRESULTINGZONES'
+FRAGMENTBUFFERSIZE = 'FRAGMENTBUFFERSIZE'
 FRAME = 'FRAME'
 FRAMEAXIS = 'FRAMEAXIS'
 FRAMECOLLECTION = 'FRAMECOLLECTION'
@@ -558,6 +562,7 @@ GLOBALTHREEDVECTOR = 'GLOBALTHREEDVECTOR'
 GLOBALTIME = 'GLOBALTIME'
 GLOBALTWODVECTOR = 'GLOBALTWODVECTOR'
 GLOBALXY = 'GLOBALXY'
+GPUNUMBER = 'GPUNUMBER'
 GRANCHOR = 'GRANCHOR'
 GRAYSCALE = 'GRAYSCALE'
 GRAYSCALEDEPTH = 'GRAYSCALEDEPTH'
@@ -850,6 +855,7 @@ MAGNITUDELABEL = 'MAGNITUDELABEL'
 MAINTAINASPECTRATIO = 'MAINTAINASPECTRATIO'
 MAJGRIDLINEPEN = 'MAJGRIDLINEPEN'
 MAKEROUGHDRAFT = 'MAKEROUGHDRAFT'
+MANUALLYREPAIRDAMAGEDDRAWAREA = 'MANUALLYREPAIRDAMAGEDDRAWAREA'
 MAP = 'MAP'
 MARCHINGCUBEALGORITHM = 'MARCHINGCUBEALGORITHM'
 MARGIN = 'MARGIN'
@@ -878,6 +884,7 @@ MAXPTSINALINE = 'MAXPTSINALINE'
 MAXRENDERTIMEBEFOREAPPROX = 'MAXRENDERTIMEBEFOREAPPROX'
 MAXROTATELINES = 'MAXROTATELINES'
 MAXSCREENSPEED = 'MAXSCREENSPEED'
+MAXSORTEDFRAGMENTCOUNT = 'MAXSORTEDFRAGMENTCOUNT'
 MAXSTEPS = 'MAXSTEPS'
 MAXSTREAMLINES = 'MAXSTREAMLINES'
 MAXSTRIPLENGTH = 'MAXSTRIPLENGTH'
@@ -910,6 +917,7 @@ MINORLENGTH = 'MINORLENGTH'
 MINORLINETHICKNESS = 'MINORLINETHICKNESS'
 MINORTICKS = 'MINORTICKS'
 MINPIXELSFORDRAG = 'MINPIXELSFORDRAG'
+MINSORTEDFRAGMENTCOUNT = 'MINSORTEDFRAGMENTCOUNT'
 MINVISIBILITYPERCENTAGE = 'MINVISIBILITYPERCENTAGE'
 MIRRORVAR = 'MIRRORVAR'
 MIRRORVARS = 'MIRRORVARS'
@@ -978,11 +986,14 @@ OBEYCLIPPLANES = 'OBEYCLIPPLANES'
 OBEYSOURCEZONEBLANKING = 'OBEYSOURCEZONEBLANKING'
 OBJECTALIGN = 'OBJECTALIGN'
 OBJECTSET = 'OBJECTSET'
+OFFSCREENDEVICE = 'OFFSCREENDEVICE'
 OFFSET = 'OFFSET'
 OFFSET1 = 'OFFSET1'
 OFFSET2 = 'OFFSET2'
 OFFSETANGLE = 'OFFSETANGLE'
+OITSETTINGS = 'OITSETTINGS'
 OKTOEXECUTESYSTEMCOMMAND = 'OKTOEXECUTESYSTEMCOMMAND'
+ONSCREENDEVICE = 'ONSCREENDEVICE'
 OPENGLCONFIG = 'OPENGLCONFIG'
 OPENLAYOUTDIALOG = 'OPENLAYOUTDIALOG'
 OPPOSINGAXISVALUE = 'OPPOSINGAXISVALUE'
@@ -1572,6 +1583,7 @@ VISUALID = 'VISUALID'
 VOLUMECELLINTERPOLATIONMODE = 'VOLUMECELLINTERPOLATIONMODE'
 VOLUMEMODE = 'VOLUMEMODE'
 VOLUMEOBJECTSTOPLOT = 'VOLUMEOBJECTSTOPLOT'
+VULKANCONFIG = 'VULKANCONFIG'
 VVAR = 'VVAR'
 VVARLIST = 'VVARLIST'
 WAIT = 'WAIT'

tecplot/tecutil/tecutil.py

@@ -1,5 +1,5 @@
 #
-# This file was auto-generated on 2024-05-28 by tecgen.
+# This file was auto-generated on 2025-12-15 by tecgen.
 # IMPORTANT: DO NOT edit this file!
 #
 import sys
@@ -3065,6 +3065,41 @@ class TecUtil(object):
                 self.handle.tecUtilLastErrorMessageType.restype = c_int
             except AttributeError:
                 error_list.append('TecUtilLastErrorMessageType')
+            # int32_t TecUtilLayoutDatasetCount(LayoutReadDataInfo_pa ReadDataInfo)
+            try:
+                self.handle.tecUtilLayoutDatasetCount.argtypes = [c_void_p]
+                self.handle.tecUtilLayoutDatasetCount.restype = c_int32
+            except AttributeError:
+                error_list.append('TecUtilLayoutDatasetCount')
+            # TP_GIVES LayoutReadDataInfo_pa TecUtilLayoutReadDataInfo(char const * FName)
+            try:
+                self.handle.tecUtilLayoutReadDataInfo.argtypes = [c_char_p]
+                self.handle.tecUtilLayoutReadDataInfo.restype = c_void_p
+            except AttributeError:
+                error_list.append('TecUtilLayoutReadDataInfo')
+            # void TecUtilLayoutReadDataInfoDealloc(TP_RECEIVES_GIVES LayoutReadDataInfo_pa * ReadDataInfo)
+            try:
+                self.handle.tecUtilLayoutReadDataInfoDealloc.argtypes = [POINTER(c_void_p)]
+            except AttributeError:
+                error_list.append('TecUtilLayoutReadDataInfoDealloc')
+            # int32_t TecUtilLayoutReadDataInstructionCount(LayoutReadDataInfo_pa ReadDataInfo, int32_t DatasetNumber)
+            try:
+                self.handle.tecUtilLayoutReadDataInstructionCount.argtypes = [c_void_p, c_int32]
+                self.handle.tecUtilLayoutReadDataInstructionCount.restype = c_int32
+            except AttributeError:
+                error_list.append('TecUtilLayoutReadDataInstructionCount')
+            # TP_GIVES char * TecUtilLayoutReadDataInstructionLoader(LayoutReadDataInfo_pa ReadDataInfo, int32_t DatasetNumber, int32_t InstructionNumber)
+            try:
+                self.handle.tecUtilLayoutReadDataInstructionLoader.argtypes = [c_void_p, c_int32, c_int32]
+                self.handle.tecUtilLayoutReadDataInstructionLoader.restype = POINTER(c_char)
+            except AttributeError:
+                error_list.append('TecUtilLayoutReadDataInstructionLoader')
+            # TP_GIVES char * TecUtilLayoutReadDataInstructions(LayoutReadDataInfo_pa ReadDataInfo, int32_t DatasetNumber, int32_t InstructionNumber)
+            try:
+                self.handle.tecUtilLayoutReadDataInstructions.argtypes = [c_void_p, c_int32, c_int32]
+                self.handle.tecUtilLayoutReadDataInstructions.restype = POINTER(c_char)
+            except AttributeError:
+                error_list.append('TecUtilLayoutReadDataInstructions')
             # LgIndex_t TecUtilLimitGetValue(char const * LimitString)
             try:
                 self.handle.tecUtilLimitGetValue.argtypes = [c_char_p]
@@ -9273,6 +9308,48 @@ class TecUtil(object):
         result = self.handle.tecUtilLastErrorMessageType()
         return MessageBoxType(result)
 
+    # int32_t TecUtilLayoutDatasetCount(LayoutReadDataInfo_pa ReadDataInfo)
+    @tecutil_preamble
+    def LayoutDatasetCount(self, read_data_info):
+        result = self.handle.tecUtilLayoutDatasetCount(read_data_info)
+        return result
+
+    # LayoutReadDataInfo_pa TecUtilLayoutReadDataInfo(char const * FName)
+    @tecutil_preamble
+    def LayoutReadDataInfo(self, f_name):
+        f_name_proxy = f_name.encode('utf-8') if f_name is not None else f_name
+        result = self.handle.tecUtilLayoutReadDataInfo(f_name_proxy)
+        return result
+
+    # void TecUtilLayoutReadDataInfoDealloc(TP_RECEIVES_GIVES LayoutReadDataInfo_pa * ReadDataInfo)
+    @tecutil_preamble
+    def LayoutReadDataInfoDealloc(self, read_data_info):
+        self.handle.tecUtilLayoutReadDataInfoDealloc(read_data_info)
+
+    # int32_t TecUtilLayoutReadDataInstructionCount(LayoutReadDataInfo_pa ReadDataInfo, int32_t DatasetNumber)
+    @tecutil_preamble
+    def LayoutReadDataInstructionCount(self, read_data_info, dataset_number):
+        result = self.handle.tecUtilLayoutReadDataInstructionCount(read_data_info, dataset_number)
+        return result
+
+    # char * TecUtilLayoutReadDataInstructionLoader(LayoutReadDataInfo_pa ReadDataInfo, int32_t DatasetNumber, int32_t InstructionNumber)
+    @tecutil_preamble
+    def LayoutReadDataInstructionLoader(self, read_data_info, dataset_number, instruction_number):
+        result_ptr = self.handle.tecUtilLayoutReadDataInstructionLoader(read_data_info, dataset_number, instruction_number)
+        result_char_p = cast(result_ptr, c_char_p)
+        result = None if (result_char_p is None or result_char_p.value is None) else result_char_p.value.decode('utf-8')
+        self.handle.tecUtilStringDealloc(byref(result_char_p))
+        return result
+
+    # char * TecUtilLayoutReadDataInstructions(LayoutReadDataInfo_pa ReadDataInfo, int32_t DatasetNumber, int32_t InstructionNumber)
+    @tecutil_preamble
+    def LayoutReadDataInstructions(self, read_data_info, dataset_number, instruction_number):
+        result_ptr = self.handle.tecUtilLayoutReadDataInstructions(read_data_info, dataset_number, instruction_number)
+        result_char_p = cast(result_ptr, c_char_p)
+        result = None if (result_char_p is None or result_char_p.value is None) else result_char_p.value.decode('utf-8')
+        self.handle.tecUtilStringDealloc(byref(result_char_p))
+        return result
+
     # LgIndex_t TecUtilLimitGetValue(char const * LimitString)
     @tecutil_preamble
     def LimitGetValue(self, limit_string):

tecplot/tecutil/tecutil_rpc.py

@@ -3518,6 +3518,41 @@ class TecUtilRPC(object):
   rep=self.sndrcv("LastErrorMessageType")
   self.chk(rep)
   return try_cast_to_enum(MessageBoxType, rep.args[0].int32)
+ def LayoutDatasetCount(self,read_data_info):
+  args=((ValueType.Address,c_uint64,getattr(read_data_info,'value',read_data_info)),)
+  rep=self.sndrcv("LayoutDatasetCount",*args)
+  self.chk(rep)
+  return rep.args[0].int32
+ def LayoutReadDataInfo(self,f_name):
+  args=((ValueType.Text,None,f_name),)
+  rep=self.sndrcv("LayoutReadDataInfo",*args)
+  self.chk(rep)
+  return rep.args[0].uint64
+ def LayoutReadDataInfoDealloc(self,read_data_info):
+  args=((ValueType.Address,c_uint64,read_data_info.contents.value),)
+  rep=self.sndrcv("LayoutReadDataInfoDealloc",*args)
+  self.chk(rep)
+  return rep.args[0].uint64
+ def LayoutReadDataInstructionCount(self,read_data_info,dataset_number):
+  args=((ValueType.Address,c_uint64,getattr(read_data_info,'value',read_data_info)),
+        (ValueType.Scalar,c_int32,dataset_number),)
+  rep=self.sndrcv("LayoutReadDataInstructionCount",*args)
+  self.chk(rep)
+  return rep.args[0].int32
+ def LayoutReadDataInstructionLoader(self,read_data_info,dataset_number,instruction_number):
+  args=((ValueType.Address,c_uint64,getattr(read_data_info,'value',read_data_info)),
+        (ValueType.Scalar,c_int32,dataset_number),
+        (ValueType.Scalar,c_int32,instruction_number),)
+  rep=self.sndrcv("LayoutReadDataInstructionLoader",*args)
+  self.chk(rep)
+  return self.read_text(rep.args[0])
+ def LayoutReadDataInstructions(self,read_data_info,dataset_number,instruction_number):
+  args=((ValueType.Address,c_uint64,getattr(read_data_info,'value',read_data_info)),
+        (ValueType.Scalar,c_int32,dataset_number),
+        (ValueType.Scalar,c_int32,instruction_number),)
+  rep=self.sndrcv("LayoutReadDataInstructions",*args)
+  self.chk(rep)
+  return self.read_text(rep.args[0])
  def LimitGetValue(self,limit_string):
   args=((ValueType.Text,None,limit_string),)
   rep=self.sndrcv("LimitGetValue",*args)

tecplot/tecutil/util.py

@@ -332,11 +332,11 @@ def temporary_closed_file(suffix=None):
 
 
 def api_changed(msg, version_changed, sdk_version_changed, warning=False):
-    msg = textwrap.dedent('''\
-    PyTecplot API Change (version {})
-    Tecplot 360 version: {}
-    {}
-    ''').format(version_changed, sdk_version_changed, textwrap.fill(msg))
+    detail = textwrap.indent(textwrap.dedent(msg), '    ')
+    msg = textwrap.dedent(f'''\
+    PyTecplot API Change (version {version_changed})
+    Tecplot 360 version: {sdk_version_changed}
+    ''') + detail
     if warning:
         if __debug__:
             msg += 'Please update your code as the legacy interface will\n' \
@@ -347,11 +347,11 @@ def api_changed(msg, version_changed, sdk_version_changed, warning=False):
 
 
 def api_moved(old, new, version_changed, sdk_version_changed, warning=False):
-    msg = textwrap.dedent('''\
-    PyTecplot API Change (version {})
-    Tecplot 360 version: {}
-        {} has been moved to {}
-    ''').format(version_changed, sdk_version_changed, old, new)
+    msg = textwrap.dedent(f'''\
+    PyTecplot API Change (version {version_changed})
+    Tecplot 360 version: {sdk_version_changed}
+        {old} has been moved to {new}
+    ''')
     if warning:
         if __debug__:
             msg += 'Please update your code as the legacy interface will\n' \

tecplot/version.py

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