pytecplot 1.6.0__py3-none-any.whl → 1.6.2__py3-none-any.whl

{pytecplot-1.6.0.dist-info → pytecplot-1.6.2.dist-info}/LICENSE.html

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

{pytecplot-1.6.0.dist-info → pytecplot-1.6.2.dist-info}/METADATA

@@ -1,10 +1,9 @@
 Metadata-Version: 2.1
 Name: pytecplot
-Version: 1.6.0
+Version: 1.6.2
 Summary: A Python interface to Tecplot 360
-Home-page: https://www.tecplot.com/docs/pytecplot
-Author: Tecplot, Inc.
-Author-email: support@tecplot.com
+Author-email: "Tecplot, Inc." <support@tecplot.com>
+Project-URL: homepage, https://www.tecplot.com/docs/pytecplot
 Keywords: tecplot,cfd,data analysis,scientific,scientific computing,statistics,visualization,numerical simulation,aerospace
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
@@ -31,7 +30,8 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
-Requires-Python: >=3.6
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
 License-File: LICENSE.html
 Requires-Dist: protobuf >=3.20.0
 Requires-Dist: pyzmq
@@ -102,6 +102,28 @@ questions you may have about |PyTecplot| in general.
 Change Log
 ----------
 
+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.6.2
+^^^^^^^^^^^^^^^
+
+Released with Tecplot 360 2024 R1
+
+* Updated the End User License Agreement (EULA).
+
+PyTecplot 1.6.1
+^^^^^^^^^^^^^^^
+
+Released with Tecplot 360 2023 R2
+
+* Changed behavior of `load_tecplot_szl()` when appending to align all incoming variables by name,
+  instead of position, with the previously loaded dataset.
+* Python package configuration now uses the `pyproject.toml` file.
+* Merging features from v1.5.4 and v1.5.3 back into the main production branch. This
+  was missing from the v1.6.0 release.
+
 PyTecplot 1.6.0
 ^^^^^^^^^^^^^^^
 
@@ -121,7 +143,8 @@ Released with Tecplot 360 2023 R1
 PyTecplot 1.5.4
 ^^^^^^^^^^^^^^^
 
-* Clarified error messages on failure to initialize the Tecplot 360 libraries from Python.
+* Clarified error messages on failure to initialize the Tecplot 360 libraries from
+  Python.
 
 PyTecplot 1.5.3
 ^^^^^^^^^^^^^^^

{pytecplot-1.6.0.dist-info → pytecplot-1.6.2.dist-info}/RECORD

@@ -2,7 +2,7 @@ tecplot/__init__.py,sha256=iHAPbGDgIh7HtLWaWcDYfVS4TOsNrRSHyQa-H_6Li3g,3550
 tecplot/constant.py,sha256=a-hty3FoPqCfQn2UJQDANQwGg0G1ThNWuETWLETsA2M,8503
 tecplot/exception.py,sha256=YB4zeL0-07yCy4pyUqeFdNQ98nK11h2n3ZHHe58Od6s,6493
 tecplot/macro.py,sha256=uE29ftjdr2HdlFVa9SS-1uBU8Di4W3PwquhI75LnvhM,13307
-tecplot/version.py,sha256=LY7z-wyLT0hQned3YSwvkQbMouy5-mpc-QKCFfxefew,1544
+tecplot/version.py,sha256=R8w3ZSfvCelfBX4UG3F37sJ-k2kDcKJm9DCome_0f1s,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
@@ -10,20 +10,20 @@ tecplot/annotation/georeference.py,sha256=fB35i1MARQorSopdZw1ljgjqpC2G16YOxUBW7q
 tecplot/annotation/image.py,sha256=6v_EUYQ1gUoHIqMlJXO68S8nSuvwSnPHePwRKmtmYM4,5888
 tecplot/annotation/iter.py,sha256=s9rFJLhKgJKApxxTghRFBjT6Pmu6BAEfvB5QgBI4mNI,3709
 tecplot/annotation/polyline.py,sha256=bw-1LfpjfcHK7VZGTf7xrvHtzjlFJAegIYrU5GVdse0,12390
-tecplot/annotation/text.py,sha256=ueKAOL_SMtrV7g8HimIrP_dVg0qDV8yvn4yWjz2iEmA,26467
+tecplot/annotation/text.py,sha256=JFaaOJR1h6LyLt9vUVanQmakXtGZOguVdA-3oT8tWhQ,26471
 tecplot/data/__init__.py,sha256=apkztrNGBSS5cfyYSIYkrwU1eeRiO0GP4sHvryPJfVA,1937
 tecplot/data/array.py,sha256=kx_UPZ4MgzydzEkHhdV8YyssOuy4EzP-i4gXvvTAaxM,23885
 tecplot/data/create.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 tecplot/data/dataset.py,sha256=sXQFB3ZX9CyZPMW__uR0AmBZw8g4F0OSfkpQd5cOk_M,80705
-tecplot/data/extract.py,sha256=eM-OyVmgOTBhwQh1D36KHZ2kQKseHdJuDIiIoaVK1Qk,21395
+tecplot/data/extract.py,sha256=hVVxbU_zqlW9ZBDHuYxm5Nu2fzjvxkwsRozosTNkm60,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=pVC5sKiY2YJRAqT5E5aqpCMLopEv4RwdCX30yyEmpf4,106708
+tecplot/data/load.py,sha256=Z7UsMWn0f1loXzxSOMXj4F2H7O9CxlLtZzXnPNvgotY,109490
 tecplot/data/nodemap.py,sha256=Fn8datS0V9hXXkmGIIU1hWndCmfMk_1aLgz0MvxT8lw,36226
 tecplot/data/operate.py,sha256=oFBOzLPYnA8hUCaeiTdpPXdFlLZNLoQCb-EHcPE5iDA,42593
 tecplot/data/query.py,sha256=Ocr9h1I2bFuJFLVOFEqiCUnuxTzD4wnToNzYk996GhY,14807
-tecplot/data/save.py,sha256=TQCbEgM0QaSyMpttHPAa_qch8qCOeSQ--7pQVe4UFD4,16608
+tecplot/data/save.py,sha256=_535HsEUopTgWl-9NzDkYOQH2FDfTUO2k4EypOnsfrU,16609
 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
@@ -39,7 +39,7 @@ tecplot/layout/frame.py,sha256=mV6l1msr-uqOCGHAfgOI-cNsiFwhjUHXYmAsukZpfSw,51606
 tecplot/layout/layout.py,sha256=vcrqWgOkcEW90VCbLG2-7xSWajPhP3cRsLnRIrcuO4c,16025
 tecplot/layout/page.py,sha256=MqX3jJAd3o2xkfaSGXU7TD4gnXv-9CQcDj5WJnlIisU,18264
 tecplot/legend/__init__.py,sha256=zj94bHuUKvgWxn5dddEuahKCXVDMOFonQNgKxtuNSTQ,185
-tecplot/legend/contour_legend.py,sha256=DtXy84WwnodUNnv-mWL_1-d58xgP_8XPxFOJGelDLck,17416
+tecplot/legend/contour_legend.py,sha256=cLaxUNLD627ps6AQqIUQEoQYtQMJ41DJ1F2G53Hpp_4,17417
 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
@@ -47,7 +47,7 @@ tecplot/legend/scatter_legend.py,sha256=_td5uXO2u3PxT-cCYfGlMVZWHuA4k9i75YYzvLdH
 tecplot/plot/__init__.py,sha256=2fOlr0Xb48oHO5-OTioxN0yls-2LCPbptzuCusnag9c,3950
 tecplot/plot/axes.py,sha256=ix_rANTSZdMXWfrBDeR5Zq4AWkJ1hXkog1ply6oSbPI,26962
 tecplot/plot/axis.py,sha256=3cgOPbgQdCAWueqfjOpZUbPdhYLsw3bqw4Apm7vEaRQ,43264
-tecplot/plot/blanking.py,sha256=6y5ph3Rp6oJFhTGIOokS-NDWFxEox1R84k1CexQ8Ya4,20239
+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
@@ -55,7 +55,7 @@ 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/labels.py,sha256=ac8Dl37lGbkY78cJJo_aCuN9zslYZthSZqriTHGkPOs,10578
-tecplot/plot/linemap.py,sha256=V1-8MEaXudhB9m7jqFX633LP5ojIQAM_aiJL1OZAllc,63636
+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
@@ -76,24 +76,24 @@ 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=iNIlfkM47acj7gQE0T67on4H10n25paxMjYK4O9_VLQ,19174
+tecplot/tecutil/constant.py,sha256=EDZ2XQu0L_0wTVjiI6OxMVdX8SVh_nk_jklq58CmzeQ,19174
 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=ysUfHFT1wnyVjXQ3DJsQwY4oc8lpe93SfZkQq5oS72U,54100
-tecplot/tecutil/tecutil.py,sha256=qaNRZo13pcfr4u06v9ZJxRcYZsAjwSF1-NDrxUDghBo,693311
+tecplot/tecutil/sv.py,sha256=8EUln_hn7c2FZ3QMiK9zWMSxAQdhbKmKlTLvU-9lZ-4,54100
+tecplot/tecutil/tecutil.py,sha256=Zmz8LvQ3l25QAbIZgMjZQQHgnA-r6lgYu5n-lYwNMeo,691565
 tecplot/tecutil/tecutil_client.py,sha256=pQKqImoPQRM5K_TdyHCGHwZQr0OycIeIAjRfp5l3L7o,23671
-tecplot/tecutil/tecutil_connector.py,sha256=9Z4hZTpWKLuRN8X7uJEB6_pbD7VLLpMvzvdKvfipHZE,37273
-tecplot/tecutil/tecutil_rpc.py,sha256=VZS_UO6RKSvOAJeXe0BU-1eyuyBbty5nhHFeiDb0amo,287511
+tecplot/tecutil/tecutil_connector.py,sha256=Eh94ePUw5Reza6nwzILqVlQVWvhBfPoYK24ZsjBpHuQ,36978
+tecplot/tecutil/tecutil_rpc.py,sha256=sHX6JjNXQcVjSNasH9auydbfyZoJMF56lJF0j6TxQMM,285726
 tecplot/tecutil/util.py,sha256=C8nNB3gFK6XY6l9Ue18zcPZXFrX5JJ9vO-kcA9R53U8,12038
 tecplot/text/__init__.py,sha256=hXk-XwewRyS-yxif3Wx5FS1wO5Uh6WQpRgtUiUfjNo0,112
 tecplot/text/font.py,sha256=tHMT2NGJC8rLCVCUdmxK0YN_f4hZpTevWIofwjAp7cs,6722
 tecplot/text/label_format.py,sha256=24MOvWtVZ_SKdcU16i5yEfxC-hBipmNOLQwJ_kzDr3k,12328
 tecplot/text/textbox.py,sha256=nwr0ReRC56MY5gB7Ie6UdDxrd_Os_ZI1_3n4bmOzalU,2882
-pytecplot-1.6.0.dist-info/LICENSE.html,sha256=M3wq4JZjjVwoa8kHnmykU8xiVekNUEYSczl6BRVnjkQ,27693
-pytecplot-1.6.0.dist-info/METADATA,sha256=eJ1D9EVLhxQOMZ_w_4AN7t38Fdrl9n0N7cO85J7RHbA,20799
-pytecplot-1.6.0.dist-info/WHEEL,sha256=5sUXSg9e4bi7lTLOHcm6QEYwO5TIF1TNbTSVFVjcJcc,92
-pytecplot-1.6.0.dist-info/top_level.txt,sha256=gU7HYnAb3AVBIKRUOASdYO0QRI6hg1raLt8aN5E4o7s,8
-pytecplot-1.6.0.dist-info/RECORD,,
+pytecplot-1.6.2.dist-info/LICENSE.html,sha256=SB6NHYAw2pnpGIjyaVCyuarotJKB1OQlgIiYq-09FiM,27908
+pytecplot-1.6.2.dist-info/METADATA,sha256=boJulMdjDDVCCbDB_LvQTEwK7SQWXG42Wq9GFA7yKLc,21576
+pytecplot-1.6.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+pytecplot-1.6.2.dist-info/top_level.txt,sha256=gU7HYnAb3AVBIKRUOASdYO0QRI6hg1raLt8aN5E4o7s,8
+pytecplot-1.6.2.dist-info/RECORD,,

{pytecplot-1.6.0.dist-info → pytecplot-1.6.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.41.1)
+Generator: bdist_wheel (0.43.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

tecplot/annotation/text.py

@@ -277,11 +277,11 @@ class TextBox(object):
 
     @property
     def type(self):
-        """`constant.TextBox`: Style of the text box fill area and border.
+        r"""`constant.TextBox`: Style of the text box fill area and border.
 
         The text box type can be set to the following:
 
-            * None\_ - (default) No box is drawn around the text.
+            * ``None_`` - (default) No box is drawn around the text.
             * Filled - A filled box around the text which is opaque. if you
                 place it over another |Tecplot 360| object, the underlying
                 object cannot be seen.

tecplot/data/extract.py

@@ -257,7 +257,9 @@ def extract_slice(origin=(0, 0, 0), normal=(0, 0, 1), source=None,
                   mode=ExtractMode.SingleZone, copy_cell_centers=None,
                   assign_strand_ids=None,
                   transient_mode=TransientOperationMode.SingleSolutionTime,
-                  frame=None, dataset=None, **kw):
+                  frame=None, dataset=None,
+                  resulting_1d_zone_type=Resulting1DZoneType.FELineSegment,
+                  **kw):
     """Create new zone from a plane in the dataset.
 
     Parameters:
@@ -293,6 +295,10 @@ def extract_slice(origin=(0, 0, 0), normal=(0, 0, 1), source=None,
         dataset (`Dataset <tecplot.data.Dataset>`, optional): The `Dataset <tecplot.data.Dataset>` to operate on which must
             be attached to *frame* if given. (default: currently active
             `Dataset <tecplot.data.Dataset>`)
+        resulting_1d_zone_type (`Resulting1DZoneType`, optional): The type
+            of zone to create when the result is one-dimensional. Possible
+            values are: `Resulting1DZoneType.FELineSegment` (default)
+            and `Resulting1DZoneType.IOrderedIfPossible`.
 
     Returns:
         One or a `list` of `Zones <data_access>` representing a planar slice.
@@ -409,6 +415,8 @@ def extract_slice(origin=(0, 0, 0), normal=(0, 0, 1), source=None,
                 raise TecplotSystemError()
             if dataset.num_zones == nzones:
                 raise TecplotLogicError('No zones found when extracting slice')
+            zone_type = Resulting1DZoneType(resulting_1d_zone_type)
+            arglist[sv.RESULTING1DZONETYPE] = zone_type
 
         if (
             mode == ExtractMode.SingleZone and

tecplot/data/load.py

@@ -60,8 +60,32 @@ def _tecplot_loader_load_data(arglist,
 
         return frame.dataset
 
+#
+# This is used by load_tecplot and then only one V3 laoder (load_tecplot_szl)
+# We could extend this to be used by other V3 loaders as well.  Keep in mind,
+# for V3 loaders, this is only used when appending and some V3 loader may have
+# their own instruction for how to treat variables for a single load instruction.
+#
+def _set_var_load_instructions(variables, arglist, allocd):
+    # default var load mode is ByName
+    if variables is None:
+        arglist[sv.VARLOADMODE] = VarLoadMode.ByName
+    else:
+        if isinstance(variables[0], int):
+            arglist[sv.VARLOADMODE] = VarLoadMode.ByPosition
+            varset = IndexSet(*variables)
+            allocd.append(varset)
+            arglist[sv.VARPOSITIONLIST] = varset
+        elif isinstance(variables[0], str):
+            arglist[sv.VARLOADMODE] = VarLoadMode.ByName
+            var_string_list = StringList(*variables)
+            allocd.append(var_string_list)
+            arglist[sv.VARNAMELIST] = var_string_list
+        else:
+            err = 'unknown type for variables: {}'
+            raise TecplotTypeError(err.format(type(variables)))
 
-def append_filelist(instr, cmd, *filenames):
+def _append_filelist(instr, cmd, *filenames):
     instr.extend([cmd, sum(map(len, filenames))])
     for flist in filenames:
         instr.extend(flist)
@@ -144,7 +168,7 @@ def load_converge_hdf5(filenames,
     with tecutil.StringList('STANDARDSYNTAX', '1.0') as instr:
         with tecutil.ArgList() as arglist:
             arglist[sv.DATASETREADER] = 'CONVERGE HDF5 File Loader'
-            append_filelist(instr, 'FILELIST_DATAFILES', filenames)
+            _append_filelist(instr, 'FILELIST_DATAFILES', filenames)
             arglist[sv.FILENAMESORINSTRUCTIONS] = instr
             return _tecplot_loader_load_data(
                 arglist, frame=frame, read_data_option=read_data_option,
@@ -212,7 +236,7 @@ def load_converge_output(filenames,
     with StringList('STANDARDSYNTAX', '1.0') as instr:
         with tecutil.ArgList() as arglist:
             arglist[sv.DATASETREADER] = 'CONVERGE Output File Loader'
-            append_filelist(instr, 'FILELIST', filenames)
+            _append_filelist(instr, 'FILELIST', filenames)
             arglist[sv.FILENAMESORINSTRUCTIONS] = instr
             return _tecplot_loader_load_data(
                 arglist, frame=frame, read_data_option=read_data_option,
@@ -277,7 +301,7 @@ def load_converge_cgns(filenames,
     with StringList('STANDARDSYNTAX', '1.0') as instr:
         with tecutil.ArgList() as arglist:
             arglist[sv.DATASETREADER] = 'CONVERGE CGNS File Loader'
-            append_filelist(instr, 'FILELIST_DATAFILES', filenames)
+            _append_filelist(instr, 'FILELIST_DATAFILES', filenames)
             arglist[sv.FILENAMESORINSTRUCTIONS] = instr
             return _tecplot_loader_load_data(
                 arglist, frame=frame, read_data_option=read_data_option,
@@ -354,7 +378,7 @@ def load_fvcom(filenames,
     with StringList('STANDARDSYNTAX', '1.0') as instr:
         with tecutil.ArgList() as arglist:
             arglist[sv.DATASETREADER] = 'FVCOM netCDF Loader'
-            append_filelist(instr, 'FILELIST_DATAFILES', filenames)
+            _append_filelist(instr, 'FILELIST_DATAFILES', filenames)
             arglist[sv.FILENAMESORINSTRUCTIONS] = instr
             return _tecplot_loader_load_data(
                 arglist, frame=frame, read_data_option=read_data_option,
@@ -501,7 +525,7 @@ def load_cgns(filenames,
             # although this setting is not exposed in the API.
             instr += ['CgnsLibraryVersion', '3.1.4']
 
-            append_filelist(instr, 'FILELIST_CGNSFILES', filenames)
+            _append_filelist(instr, 'FILELIST_CGNSFILES', filenames)
 
             if zones is not None:
                 indexes = [str(int(z)) for z in zones]
@@ -695,10 +719,10 @@ def load_fluent(case_filenames=None,
             if case_filenames is not None:
                 instr += ['LoadOption', 'MultipleCaseAndData']
                 if data_filenames is not None:
-                    append_filelist(instr, 'FILELIST_Files', case_filenames,
+                    _append_filelist(instr, 'FILELIST_Files', case_filenames,
                                     data_filenames)
                 else:
-                    append_filelist(instr, 'FILELIST_Files', case_filenames)
+                    _append_filelist(instr, 'FILELIST_Files', case_filenames)
             else:
                 assert len(data_filenames) == 1
                 instr += ['LoadOption', 'ResidualsOnly']
@@ -864,7 +888,7 @@ def load_fluent_cff(filenames,
     with tecutil.StringList('STANDARDSYNTAX', '1.0') as instr:
         with tecutil.ArgList() as arglist:
             arglist[sv.DATASETREADER] = 'Fluent Common Fluid Files Loader'
-            append_filelist(instr, 'FILELIST_DATAFILES', filenames)
+            _append_filelist(instr, 'FILELIST_DATAFILES', filenames)
             arglist[sv.FILENAMESORINSTRUCTIONS] = instr
             if solution_time_source is not None:
                 instr += ['SolutionTimeSource',
@@ -958,7 +982,7 @@ def load_telemac(filenames=None,
 
             if filenames is not None:
                 filenames = tecutil.normalize_filenames(filenames)
-                append_filelist(instr, 'FILELIST_TELEMAC', filenames)
+                _append_filelist(instr, 'FILELIST_TELEMAC', filenames)
 
             if boundary_filename is not None:
                 instr += ['FILENAME_BOUNDARY',
@@ -1129,11 +1153,11 @@ def load_plot3d(grid_filenames=None,
                     instr += ['Append', 'No']
 
             if grid_filenames is not None:
-                append_filelist(instr, 'FILELIST_GRIDFILES', grid_filenames)
+                _append_filelist(instr, 'FILELIST_GRIDFILES', grid_filenames)
             if solution_filenames is not None:
-                append_filelist(instr, 'FILELIST_SOLUTIONFILES', solution_filenames)
+                _append_filelist(instr, 'FILELIST_SOLUTIONFILES', solution_filenames)
             if function_filenames is not None:
-                append_filelist(instr, 'FILELIST_FUNCTIONFILES', function_filenames)
+                _append_filelist(instr, 'FILELIST_FUNCTIONFILES', function_filenames)
             if name_filename is not None:
                 instr += ['FILENAME_NAMEFILE',
                           tecutil.normalize_path(name_filename)]
@@ -1396,7 +1420,7 @@ def load_kiva(filenames,
     with StringList('STANDARDSYNTAX', '1.0') as instr:
         with tecutil.ArgList() as arglist:
             arglist[sv.DATASETREADER] = 'Kiva Loader'
-            append_filelist(instr, 'FILELIST_DataFiles', filenames)
+            _append_filelist(instr, 'FILELIST_DataFiles', filenames)
             instr += ['ISDOUBLE', 'YES' if is_double else 'No']
             instr += ['LOADPARTICLEDATA', 'YES' if load_particle_data else 'No']
             instr += ['VELVECTOR', str(velocity_vector)]
@@ -1716,7 +1740,7 @@ def load_vtk(filenames,
     with StringList('STANDARDSYNTAX', '1.0') as instr:
         with tecutil.ArgList() as arglist:
             arglist[sv.DATASETREADER] = 'VTK Data Loader'
-            append_filelist(instr, 'FILELIST_DATAFILES', filenames)
+            _append_filelist(instr, 'FILELIST_DATAFILES', filenames)
             instr += ['SOLUTIONTIMESOURCE',
                       VTKLoader.SolutionTimeSource(solution_time_source).value]
             arglist[sv.FILENAMESORINSTRUCTIONS] = instr
@@ -1797,7 +1821,11 @@ def load_tecplot(filenames,
             <data_access>` to load. Use `None` to load all zones. (default:
             `None`)
         variables (`set` of `strings <str>` or `integers <int>`, optional):
-            Set of `Variables <Variable>` to load. Use `None` to load all
+            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 
+            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`)
 
         collapse (`bool`, optional): Reindex `Zones <data_access>` and
@@ -1866,23 +1894,8 @@ def load_tecplot(filenames,
                 allocd.append(zoneset)
                 arglist[sv.ZONELIST] = zoneset
 
-            if variables is None:
-                arglist[sv.VARLOADMODE] = VarLoadMode.ByName
+            _set_var_load_instructions(variables, arglist, allocd)
 
-            else:
-                if isinstance(variables[0], int):
-                    arglist[sv.VARLOADMODE] = VarLoadMode.ByPosition
-                    varset = IndexSet(*variables)
-                    allocd.append(varset)
-                    arglist[sv.VARPOSITIONLIST] = varset
-                elif isinstance(variables[0], str):
-                    arglist[sv.VARLOADMODE] = VarLoadMode.ByName
-                    var_string_list = StringList(*variables)
-                    allocd.append(var_string_list)
-                    arglist[sv.VARNAMELIST] = var_string_list
-                else:
-                    err = 'unknown type for variables: {}'
-                    raise TecplotTypeError(err.format(type(variables)))
             if skip is not None:
                 i, j, k = skip
                 arglist[sv.ISKIP] = i
@@ -1911,6 +1924,8 @@ def load_tecplot_szl(filenames,
                      reset_style=None,
                      initial_plot_first_zone_only=None,
                      initial_plot_type=None,
+
+
                      assign_strand_ids=True,
                      add_zones_to_existing_strands=None,
 
@@ -1920,6 +1935,32 @@ def load_tecplot_szl(filenames,
                      authentication_method=None,
                      ssh_private_keyfile=pathlib.Path('~/.ssh/id_rsa'),
                      szlserver_path=None):
+
+#
+#       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 
+#       "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 
+#       $!READDATASET command (i.e. only applied to appending for V3 Loaders)
+#
+#       Proposed is to add:
+#
+#           appending_variables=None,   
+#
+#       Documentation then will include:
+#
+#       appending_variables (`set` of `strings <str>` or `integers <int>`, optional):
+#           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 
+#           the variables at those offsets will be loaded.
+#           Use `None` to load all variables. (default: `None`)
+
     """Read tecplot SZL data file.
 
     Parameters:
@@ -1940,6 +1981,9 @@ def load_tecplot_szl(filenames,
                     use the old one.
                 * `ReadDataOption.Append`
                     Append to the existing `Dataset <tecplot.data.Dataset>`.
+                    Note also that when appending, the variables in the incoming dataset
+                    will be matched up with the existing variables by name and any new
+                    variables will be added to the end of the list.
                 * `ReadDataOption.Replace`
                     Replace the `Dataset <tecplot.data.Dataset>` attached to the active
                     frame and to all other frames that use the same `Dataset
@@ -2085,14 +2129,29 @@ def load_tecplot_szl(filenames,
 
                 if szlserver_path is not None:
                     instr += ['Server Executable Path', str(szlserver_path)]
-        append_filelist(instr, 'FILELIST_DATAFILES', filenames)
+        _append_filelist(instr, 'FILELIST_DATAFILES', filenames)
+
+        allocd = []
+
+        # Var load mode and variables options are ONLY used when appending
+        # with V3 Loaders (unlike the native tecplot loader)
+        # For now this is hard coded to None thus making the szl loader hard
+        # coded to load by name and consider all variables.
+        #
+        appending_variables = None
+        if read_data_option is ReadDataOption.Append:
+            _set_var_load_instructions(appending_variables, arglist, allocd)
 
         with tecutil.StringList(*instr) as instr:
             arglist[sv.FILENAMESORINSTRUCTIONS] = instr
-            return _tecplot_loader_load_data(
-                arglist, frame=frame, read_data_option=read_data_option,
-                reset_style=reset_style,
-                initial_plot_first_zone_only=initial_plot_first_zone_only,
-                initial_plot_type=initial_plot_type,
-                assign_strand_ids=assign_strand_ids,
-                add_zones_to_existing_strands=add_zones_to_existing_strands)
+            try:
+                return _tecplot_loader_load_data(
+                    arglist, frame=frame, read_data_option=read_data_option,
+                    reset_style=reset_style,
+                    initial_plot_first_zone_only=initial_plot_first_zone_only,
+                    initial_plot_type=initial_plot_type,
+                    assign_strand_ids=assign_strand_ids,
+                    add_zones_to_existing_strands=add_zones_to_existing_strands)
+            finally:
+                for a in allocd:
+                    a.dealloc()

tecplot/data/save.py

@@ -93,7 +93,7 @@ def save_tecplot_ascii(filename, frame=None, dataset=None, zones=None,
             and write the variable and connectivity linkage wherever
             possible. If `False`, this will write out all data, losing the
             connectivity sharing linkage for future dataset reads of the
-            file. (default: `True`)
+            file. (default: `False`)
         include_autogen_face_neighbors (`bool`, optional): Save the
             face neighbor connectivity. This may produce very large data
             files. (default: `False`)

tecplot/legend/contour_legend.py

@@ -115,7 +115,7 @@ class LegendHeader(session.Style):
 
     @property
     def text_type(self):
-        """`TextType`: Typesetter for the contour legend header.
+        r"""`TextType`: Typesetter for the contour legend header.
 
         This determines how the header text for the contour legend
         is rendered. Options are `TextType.Regular` or `TextType.LaTeX`.

tecplot/plot/blanking.py

@@ -556,7 +556,7 @@ class IJKBlanking(session.Style):
         """`tuple`: Minimum :math:`(i, j, k)` values in percent.
 
         The percentage is of the total range of the dataset in each dimension.
-        This example sets the minimum to 50\% in each of the :math:`(i, j, k)`
+        This example sets the minimum to 50% in each of the :math:`(i, j, k)`
         dimensions::
 
             >>> plot.ijk_blanking.min_percent = (50, 50, 50)
@@ -572,7 +572,7 @@ class IJKBlanking(session.Style):
         """`tuple`: Maximum :math:`(i, j, k)` values in percent.
 
         The percentage is of the total range of the dataset in each dimension.
-        This example sets the maximum to 90\% in each of the :math:`(i, j, k)`
+        This example sets the maximum to 90% in each of the :math:`(i, j, k)`
         dimensions::
 
             >>> plot.ijk_blanking.max_percent = (90, 90, 90)

tecplot/plot/linemap.py

@@ -228,7 +228,7 @@ class LinemapCurve(session.SubStyle):
 
     @property
     def curve_type(self):
-        """`CurveType`: Type of curve to draw or fit.
+        r"""`CurveType`: Type of curve to draw or fit.
 
         Possible values: `LineSeg`, `PolynomialFit`, `EToRFit`, `PowerFit`,
         `Spline`, `ParaSpline`.
@@ -1324,7 +1324,7 @@ class LinemapCollection(session.Style):
 
     @property
     def zone(self):
-        """`tuple` of `Zones <data_access>`: `Zones <data_access>` of this :ref:`LinemapCollection`.
+        """`tuple` of `Zones <data_access>`: `Zones <data_access>` of this linemap collection.
 
         Example usage::
 

tecplot/tecutil/constant.py

@@ -1,5 +1,5 @@
 #
-# This file was auto-generated on 2023-04-28 by tecgen.
+# This file was auto-generated on 2024-05-28 by tecgen.
 # IMPORTANT: DO NOT edit this file!
 #
 from enum import Enum as _Enum

tecplot/tecutil/sv.py

@@ -1,5 +1,5 @@
 #
-# This file was auto-generated on 2023-04-28 by tecgen.
+# This file was auto-generated on 2024-05-28 by tecgen.
 # IMPORTANT: DO NOT edit this file!
 #
 

tecplot/tecutil/tecutil.py

@@ -1,5 +1,5 @@
 #
-# This file was auto-generated on 2023-04-28 by tecgen.
+# This file was auto-generated on 2024-05-28 by tecgen.
 # IMPORTANT: DO NOT edit this file!
 #
 import sys
@@ -473,12 +473,18 @@ class TecUtil(object):
                 self.handle.tecUtilBlankingCheckDataPoint.restype = c_bool
             except AttributeError:
                 error_list.append('TecUtilBlankingCheckDataPoint')
-            # TP_QUERY Boolean_t TecUtilBlankingCheckFECell(EntIndex_t Zone, LgIndex_t CellIndex)
+            # TP_QUERY Boolean_t TecUtilBlankingCheckFECell(EntIndex_t zone, LgIndex_t cellIndex)
             try:
                 self.handle.tecUtilBlankingCheckFECell.argtypes = [c_int32, c_int64]
                 self.handle.tecUtilBlankingCheckFECell.restype = c_bool
             except AttributeError:
                 error_list.append('TecUtilBlankingCheckFECell')
+            # TP_QUERY Boolean_t TecUtilBlankingCheckFEElem(EntIndex_t zone, EntIndex_t section, LgIndex_t cellIndex)
+            try:
+                self.handle.tecUtilBlankingCheckFEElem.argtypes = [c_int32, c_int32, c_int64]
+                self.handle.tecUtilBlankingCheckFEElem.restype = c_bool
+            except AttributeError:
+                error_list.append('TecUtilBlankingCheckFEElem')
             # TP_QUERY Boolean_t TecUtilBlankingCheckIJKCell(EntIndex_t Zone, IJKPlanes_e ZonePlane, LgIndex_t CellIndex)
             try:
                 self.handle.tecUtilBlankingCheckIJKCell.argtypes = [c_int32, c_int, c_int64]
@@ -3043,11 +3049,6 @@ class TecUtil(object):
                 self.handle.tecUtilInverseDistInterpolation.restype = c_bool
             except AttributeError:
                 error_list.append('TecUtilInverseDistInterpolation')
-            # TP_QUERY Boolean_t TecUtilIsBusy()
-            try:
-                self.handle.tecUtilIsBusy.restype = c_bool
-            except AttributeError:
-                error_list.append('TecUtilIsBusy')
             # Boolean_t TecUtilKrig(Set_pa SourceZones, EntIndex_t DestZone, Set_pa VarList, double KrigRange, double KrigZeroValue, Drift_e KrigDrift, PtSelection_e InterpPtSelection, LgIndex_t InterpNPoints)
             try:
                 self.handle.tecUtilKrig.argtypes = [c_void_p, c_int32, c_void_p, c_double, c_double, c_int, c_int, c_int64]
@@ -3064,18 +3065,6 @@ class TecUtil(object):
                 self.handle.tecUtilLastErrorMessageType.restype = c_int
             except AttributeError:
                 error_list.append('TecUtilLastErrorMessageType')
-            # int32_t TecUtilLicenseCheckOut(char const * Feature)
-            try:
-                self.handle.tecUtilLicenseCheckOut.argtypes = [c_char_p]
-                self.handle.tecUtilLicenseCheckOut.restype = c_int32
-            except AttributeError:
-                error_list.append('TecUtilLicenseCheckOut')
-            # int32_t TecUtilLicenseGetInfo(char const * Feature, TP_GIVES char * * VendorData, TP_OUT time_t * ExpirationDate)
-            try:
-                self.handle.tecUtilLicenseGetInfo.argtypes = [c_char_p, POINTER(c_char_p), POINTER(c_int64)]
-                self.handle.tecUtilLicenseGetInfo.restype = c_int32
-            except AttributeError:
-                error_list.append('TecUtilLicenseGetInfo')
             # LgIndex_t TecUtilLimitGetValue(char const * LimitString)
             try:
                 self.handle.tecUtilLimitGetValue.argtypes = [c_char_p]
@@ -6156,12 +6145,18 @@ class TecUtil(object):
         result = self.handle.tecUtilBlankingCheckDataPoint(zone, point_index)
         return result
 
-    # Boolean_t TecUtilBlankingCheckFECell(EntIndex_t Zone, LgIndex_t CellIndex)
+    # Boolean_t TecUtilBlankingCheckFECell(EntIndex_t zone, LgIndex_t cellIndex)
     @tecutil_preamble
     def BlankingCheckFECell(self, zone, cell_index):
         result = self.handle.tecUtilBlankingCheckFECell(zone, cell_index)
         return result
 
+    # Boolean_t TecUtilBlankingCheckFEElem(EntIndex_t zone, EntIndex_t section, LgIndex_t cellIndex)
+    @tecutil_preamble
+    def BlankingCheckFEElem(self, zone, section, cell_index):
+        result = self.handle.tecUtilBlankingCheckFEElem(zone, section, cell_index)
+        return result
+
     # Boolean_t TecUtilBlankingCheckIJKCell(EntIndex_t Zone, IJKPlanes_e ZonePlane, LgIndex_t CellIndex)
     @tecutil_preamble
     def BlankingCheckIJKCell(self, zone, zone_plane, cell_index):
@@ -8153,11 +8148,6 @@ class TecUtil(object):
         self.handle.tecUtilStringDealloc(byref(temp_file_name_out))
         return result, temp_file_name_out_value
 
-    # void TecUtilFinishInteractiveViewChange()
-    @tecutil_preamble
-    def FinishInteractiveViewChange(self):
-        self.handle.tecUtilFinishInteractiveViewChange()
-
     # Boolean_t TecUtilFormatTimeDateString(double inputDate, char const * formattingMask, TP_GIVES char * * formattedValue)
     @tecutil_preamble
     def FormatTimeDateString(self, input_date, formatting_mask):
@@ -9258,12 +9248,6 @@ class TecUtil(object):
         result = self.handle.tecUtilInverseDistInterpolation(source_zones, dest_zone, var_list, inv_dist_exponent, inv_dist_min_radius, interp_pt_selection, interp_n_points)
         return result
 
-    # Boolean_t TecUtilIsBusy()
-    @tecutil_preamble
-    def IsBusy(self):
-        result = self.handle.tecUtilIsBusy()
-        return result
-
     # Boolean_t TecUtilKrig(Set_pa SourceZones, EntIndex_t DestZone, Set_pa VarList, double KrigRange, double KrigZeroValue, Drift_e KrigDrift, PtSelection_e InterpPtSelection, LgIndex_t InterpNPoints)
     @tecutil_preamble
     def Krig(self, source_zones, dest_zone, var_list, krig_range, krig_zero_value, krig_drift, interp_pt_selection, interp_n_points):
@@ -9289,24 +9273,6 @@ class TecUtil(object):
         result = self.handle.tecUtilLastErrorMessageType()
         return MessageBoxType(result)
 
-    # int32_t TecUtilLicenseCheckOut(char const * Feature)
-    @tecutil_preamble
-    def LicenseCheckOut(self, feature):
-        feature_proxy = feature.encode('utf-8') if feature is not None else feature
-        result = self.handle.tecUtilLicenseCheckOut(feature_proxy)
-        return result
-
-    # int32_t TecUtilLicenseGetInfo(char const * Feature, TP_GIVES char * * VendorData, TP_OUT time_t * ExpirationDate)
-    @tecutil_preamble
-    def LicenseGetInfo(self, feature):
-        feature_proxy = feature.encode('utf-8') if feature is not None else feature
-        vendor_data_out = c_char_p()
-        expiration_date_out = c_int64()
-        result = self.handle.tecUtilLicenseGetInfo(feature_proxy, byref(vendor_data_out), byref(expiration_date_out))
-        vendor_data_out_value = None if vendor_data_out.value is None else vendor_data_out.value.decode('utf-8')
-        self.handle.tecUtilStringDealloc(byref(vendor_data_out))
-        return result, vendor_data_out_value, expiration_date_out.value
-
     # LgIndex_t TecUtilLimitGetValue(char const * LimitString)
     @tecutil_preamble
     def LimitGetValue(self, limit_string):
@@ -10511,11 +10477,6 @@ class TecUtil(object):
         result = self.handle.tecUtilSolutionTimeSetToleranceFactor(dataset_id, tolerance_factor)
         return result
 
-    # void TecUtilStartInteractiveViewChange()
-    @tecutil_preamble
-    def StartInteractiveViewChange(self):
-        self.handle.tecUtilStartInteractiveViewChange()
-
     # Boolean_t TecUtilStateChangeGetArbEnum(TP_OUT int32_t * ArbEnum)
     @tecutil_preamble
     def StateChangeGetArbEnum(self):

tecplot/tecutil/tecutil_connector.py

@@ -69,10 +69,6 @@ class TecUtilConnector(object):
     Message = namedtuple('Message', ['level', 'message'])
 
     def __init__(self):
-        if __debug__:
-            # ensure log messages get out to console
-            logging.basicConfig()
-
         self.handle = None
         self.tecutil_handle = None
         self.libbatch_path = None
@@ -341,46 +337,35 @@ class TecUtilConnector(object):
                         '{}:{}'.format(fname, exc_tb.tb_lineno)]]
                 cdllexcept[libinterproc] = '\n'.join(info)
 
-        msg = dedent('''\
-            The Tecplot batch library or one of its dependencies could not be
-            found. This is usually the result of not setting the environment
-            path LD_LIBRARY_PATH to the directory containing the tecplot
-            executables.
-
-            LD_LIBRARY_PATH={libpath}
+        errmsg = dedent('''\
+            Failed to load Tecplot 360 libraries.
 
-            Library file name(s):
-                {libnames}
-        ''').format(libpath=os.environ.get('LD_LIBRARY_PATH', None),
-                    libnames='\n    '.join(libnames))
+            Try running python using the tec360-env script:
+                /tecplot360/bin/tec360-env [options] -- python [options]''')
 
         self.libbatch_path = _find_library([libbatch])
         if self.libbatch_path is None:
-            raise TecplotLibraryNotFoundError(msg)
+            log.error(dedent(f'''\
+                Failed to load Tecplot 360 libraries: {" ".join(libnames)}
+                Search path:
+                    LD_LIBRARY_PATH={os.environ.get('LD_LIBRARY_PATH', "")}
+                This is usually the result of an incorrect environment setup.
+                See the documentation here:
+                    www.tecplot.com/docs/pytecplot'''))
+            raise TecplotLibraryNotFoundError(errmsg)
 
-        msg += dedent('''
-        Found batch library file:
-            {foundlib}
-
-        Your Tecplot 360 EX may be out of date. Please install the latest
-        version of 360 EX which can be obtained here:
-            https://www.tecplot.com/downloads
-        ''').format(foundlib=self.libbatch_path)
+        log.error(f'Found batch library file: {self.libbatch_path}')
 
         missinglibs = _missinglibs(self.libbatch_path)
         if len(missinglibs):
-            msg += dedent('''
-                Missing libraries:
-                    {missinglibs}
-            ''').format(missinglibs='\n    '.join(missinglibs))
+            log.error('Missing libraries' + '\n    '.join(missinglibs))
 
         lib = path.basename(self.libbatch_path)
-        msg += dedent('''
-            Python ctypes exception caught while trying to load library:
-                {cdllexcept}
-        ''').format(cdllexcept='\n    '.join(cdllexcept[lib].split('\n')))
-
-        raise TecplotLibraryNotLoadedError(msg)
+        log.error(
+            'Python ctypes exception caught while trying to load library:'
+            + '\n    '.join(cdllexcept[lib].split('\n'))
+        )
+        raise TecplotLibraryNotLoadedError(errmsg)
 
     def load_darwin(self):
 
@@ -445,45 +430,39 @@ class TecUtilConnector(object):
                         '{}:{}'.format(fname, exc_tb.tb_lineno)]]
                 cdllexcept[libinterproc] = '\n'.join(info)
 
-        msg = dedent('''\
-            The Tecplot batch library or one of its dependencies could not be
-            found. This is usually the result of not setting the environment
-            path DYLD_LIBRARY_PATH to the directory containing the tecplot
-            executables.
+        log.error(dedent(f'''\
+            Failed to load Tecplot 360 libraries: {" ".join(libnames)}
+            Search path:
+                DYLD_LIBRARY_PATH={os.environ.get('DYLD_LIBRARY_PATH', "")}
+            This is usually the result of an incorrect environment setup.
+            See the documentation here:
+                www.tecplot.com/docs/pytecplot'''))
+        errmsg = dedent('''\
+            Failed to load Tecplot 360 libraries.
 
-            DYLD_LIBRARY_PATH={libpath}
+            Try running python using the tec360-env script included in the
+            Tecplot 360 bin folder:
+                "/Applications/Tecplot 360 EX [VERSION]/bin/tec360-env" -- python [options]
 
-            Batch library file name(s):
-                {libnames}
-        ''').format(libpath=os.environ.get('DYLD_LIBRARY_PATH', None),
-                    libnames='\n    '.join(libnames))
+            On Apple Silicon machines, an Intel version of Python is required:
+                "/Applications/Tecplot 360 EX [VERSION]/bin/tec360-env" -- python3-intel64 [options]''')
 
         if self.libbatch_path is None:
-            raise TecplotLibraryNotFoundError(msg)
-
-        msg += dedent('''
-        Found batch library file:
-            {foundlib}
+            raise TecplotLibraryNotFoundError(errmsg)
 
-        Your Tecplot 360 EX may be out of date. Please install the latest
-        version of 360 EX which can be obtained here:
-            https://www.tecplot.com/downloads
-        ''').format(foundlib=self.libbatch_path)
+        log.dedent(f'Found batch library file: {self.libbatch_path}')
 
         missinglibs = _missinglibs(self.libbatch_path)
         if len(missinglibs):
-            msg += dedent('''
-                Missing libraries:
-                    {missinglibs}
-            ''').format(missinglibs='\n    '.join(missinglibs))
+            log.error('Missing libraries:\n' + '\n    '.join(missinglibs))
 
         lib = path.basename(self.libbatch_path)
-        msg += dedent('''
-            Python ctypes exception caught while trying to load library:
-                {cdllexcept}
-        ''').format(cdllexcept='\n    '.join(cdllexcept[lib].split('\n')))
+        log.error(
+            'Python ctypes exception caught while trying to load library:\n'
+            + '\n    '.join(cdllexcept[lib].split('\n'))
+        )
 
-        raise TecplotLibraryNotLoadedError(msg)
+        raise TecplotLibraryNotLoadedError(errmsg)
 
     def load_windows(self):
 
@@ -547,24 +526,14 @@ class TecUtilConnector(object):
                 else:
                     cdllexcept.append(msg)
 
-        msg = dedent('''\
-            The Tecplot batch library or one of its dependencies could not be
-            found. This is usually the result of not setting the environment
-            path PATH to the directory containing the tecplot executables.
-            Alternatively, your Tecplot 360 EX may be out of date. Please
-            install the latest version of 360 EX which can be obtained here:
-                https://www.tecplot.com/downloads
-
+        log.error(dedent(f'''\
+            Failed to load Tecplot 360 libraries.
             Batch library file names:
                 tecutilbatch.dll
                 tecutilchecked.dll
-
-            PATH={libpath}
-
+            PATH={os.environ.get('PATH', "")}
             Found batch library file:
-                {foundlib}
-        ''').format(libpath=os.environ.get('PATH', None),
-                    foundlib=self.libbatch_path)
+                {self.libbatch_path}'''))
 
         if cdllexcept:
             info = '\n    '.join(cdllexcept[0].split('\n'))
@@ -572,15 +541,26 @@ class TecUtilConnector(object):
             if 'Error 127' in info:
                 info += ('\n***NOTE: If your script uses PyQt, ' +
                          'you must import tecplot before importing PyQt.\n')
-            msg += dedent('''
-                Python ctypes exception caught while trying to load library:
-                    {cdllexcept}
-            ''').format(cdllexcept=info)
+            log.error(
+                'Python ctypes exception caught while trying to load library:\n    '
+                + info
+            )
 
-        if self.libbatch_path is None:
-            raise TecplotLibraryNotFoundError(msg)
+        errmsg = dedent('''\
+            Failed to load Tecplot 360 libraries.
 
-        raise TecplotLibraryNotLoadedError(msg)
+            The Tecplot batch library or one of its dependencies could not be
+            found. This is usually the result of not setting the environment
+            variable PATH to the directory containing the tecplot executables.
+            See the documentation here:
+                www.tecplot.com/docs/pytecplot
+
+            Your Tecplot 360 may be out of date. Please install the latest
+            version of Tecplot 360 which can be obtained on the MyTecplot portal:
+                my.tecplot.com''')
+        if self.libbatch_path is None:
+            raise TecplotLibraryNotFoundError(errmsg)
+        raise TecplotLibraryNotLoadedError(errmsg)
 
     def start(self):
         if self.started:

tecplot/tecutil/tecutil_rpc.py

@@ -576,6 +576,13 @@ class TecUtilRPC(object):
   rep=self.sndrcv("BlankingCheckFECell",*args)
   self.chk(rep)
   return rep.args[0].boolean
+ def BlankingCheckFEElem(self,zone,section,cell_index):
+  args=((ValueType.Scalar,c_int32,zone),
+        (ValueType.Scalar,c_int32,section),
+        (ValueType.Scalar,c_int64,cell_index),)
+  rep=self.sndrcv("BlankingCheckFEElem",*args)
+  self.chk(rep)
+  return rep.args[0].boolean
  def BlankingCheckIJKCell(self,zone,zone_plane,cell_index):
   args=((ValueType.Scalar,c_int32,zone),
         (ValueType.Scalar,c_int32,IJKPlanes(zone_plane).value),
@@ -3123,15 +3130,6 @@ class TecUtilRPC(object):
   rep=self.sndrcv("GeomImageGetFileName",*args)
   self.chk(rep)
   return self.read_text(rep.args[0])
- def GeomImageGetImage(self,gid):
-  args=((ValueType.Scalar,c_int64,gid),)
-  rep=self.sndrcv("GeomImageGetImage",*args)
-  self.chk(rep)
-  return (
-   (rep.status == tecrpc.Reply.Success),
-   rep.args[0].int32,
-   rep.args[1].int32,
-   self.read_array(rep.args[2], c_uint8))
  def GeomImageGetRawSize(self,gid):
   args=((ValueType.Scalar,c_int64,gid),)
   rep=self.sndrcv("GeomImageGetRawSize",*args)
@@ -3379,15 +3377,6 @@ class TecUtilRPC(object):
  def ImageBitmapDestroy(self):
   rep=self.sndrcv("ImageBitmapDestroy")
   self.chk(rep)
- def ImageGetColorTable(self,red_array,green_array,blue_array):
-  args=((ValueType.Array,None,red_array),
-        (ValueType.Array,None,green_array),
-        (ValueType.Array,None,blue_array),)
-  rep=self.sndrcv("ImageGetColorTable",*args)
-  self.chk(rep)
-  memmove(red_array, rep.args[0].buffer, sizeof(red_array))
-  memmove(green_array, rep.args[1].buffer, sizeof(green_array))
-  memmove(blue_array, rep.args[2].buffer, sizeof(blue_array))
  def ImageGetDimensions(self):
   rep=self.sndrcv("ImageGetDimensions")
   self.chk(rep)
@@ -3395,38 +3384,11 @@ class TecUtilRPC(object):
    (rep.status == tecrpc.Reply.Success),
    rep.args[0].int32,
    rep.args[1].int32)
- def ImageIndexedBitmapCreate(self,region,red_color_table_array,green_color_table_array,blue_color_table_array):
-  args=((ValueType.Scalar,c_int32,ExportRegion(region).value),
-        (ValueType.Array,None,red_color_table_array),
-        (ValueType.Array,None,green_color_table_array),
-        (ValueType.Array,None,blue_color_table_array),)
-  rep=self.sndrcv("ImageIndexedBitmapCreate",*args)
-  self.chk(rep)
-  memmove(red_color_table_array, rep.args[0].buffer, sizeof(red_color_table_array))
-  memmove(green_color_table_array, rep.args[1].buffer, sizeof(green_color_table_array))
-  memmove(blue_color_table_array, rep.args[2].buffer, sizeof(blue_color_table_array))
-  return (rep.status == tecrpc.Reply.Success)
- def ImageIndexedGetScanLine(self,scan_line,rgb_index_array):
-  args=((ValueType.Scalar,c_int32,scan_line),
-        (ValueType.Array,None,rgb_index_array),)
-  rep=self.sndrcv("ImageIndexedGetScanLine",*args)
-  self.chk(rep)
-  memmove(rgb_index_array, rep.args[0].buffer, sizeof(rgb_index_array))
  def ImageRGBBitmapCreate(self,region):
   args=((ValueType.Scalar,c_int32,ExportRegion(region).value),)
   rep=self.sndrcv("ImageRGBBitmapCreate",*args)
   self.chk(rep)
   return (rep.status == tecrpc.Reply.Success)
- def ImageRGBGetScanLine(self,scan_line,red_array,green_array,blue_array):
-  args=((ValueType.Scalar,c_int32,scan_line),
-        (ValueType.Array,None,red_array),
-        (ValueType.Array,None,green_array),
-        (ValueType.Array,None,blue_array),)
-  rep=self.sndrcv("ImageRGBGetScanLine",*args)
-  self.chk(rep)
-  memmove(red_array, rep.args[0].buffer, sizeof(red_array))
-  memmove(green_array, rep.args[1].buffer, sizeof(green_array))
-  memmove(blue_array, rep.args[2].buffer, sizeof(blue_array))
  def ImportAddConverter(self,converter_callback,converter_name,f_name_extension):
   args=((ValueType.Address,c_uint64,getattr(converter_callback,'value',converter_callback)),
         (ValueType.Text,None,converter_name),
@@ -4484,6 +4446,12 @@ class TecUtilRPC(object):
   rep=self.sndrcv("ProbeFieldGetReadableNativeRef",*args)
   self.chk(rep)
   return rep.args[0].uint64
+ def ProbeFieldGetSectionAndElem(self):
+  rep=self.sndrcv("ProbeFieldGetSectionAndElem")
+  self.chk(rep)
+  return (
+   rep.args[0].int32,
+   rep.args[1].int64)
  def ProbeFieldGetValue(self,var):
   args=((ValueType.Scalar,c_int32,var),)
   rep=self.sndrcv("ProbeFieldGetValue",*args)

tecplot/version.py

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