tecio-python 0.3.0__tar.gz → 0.3.2__tar.gz

{tecio_python-0.3.0/tecio_python.egg-info → tecio_python-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tecio-python
-Version: 0.3.0
+Version: 0.3.2
 Summary: Python interface for reading and writing Tecplot data files
 Project-URL: Homepage, https://github.com/meersman/tecio
 Project-URL: Documentation, https://meersman.github.io/tecio/
@@ -82,6 +82,8 @@ export TECIO_LIB=/path/to/libtecio.dylib  # macOS
 
 ## Quick start
 
+Writing a file:
+
 ```python
 import tecio
 import numpy as np
@@ -90,7 +92,7 @@ x = np.linspace(0, 2 * np.pi, 100)
 y = np.sin(x)
 
 with tecio.open("sine.szplt", "w") as tec:
-    tec.write_ijk_zone(data=[x, y], variables=["x", "y"])
+    tec.write_ordered_zone(data=[x, y], variables=["x", "y"])
 ```
 
 Reading a file:
@@ -98,10 +100,10 @@ Reading a file:
 ```python
 with tecio.open("sine.szplt", "r") as tec:
     print(tec.variables)  # ['x', 'y']
-    x = tec.zone[0].variable[0].values
-    y = tec.zone[0].variable[1].values
+    x = tec.zones[0].variables[0].values
+    y = tec.zones[0].variables[1].values
     # or
-    x, y = tec.zone[0].get_array(["x", "y"])
+    x, y = tec.zones[0].get_array(["x", "y"])
 ```
 
 ## API
@@ -129,7 +131,7 @@ Supported formats:
 
 ## Contributing
 
-Contributions are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+Contributions are welcome (see [CONTRIBUTING.md](CONTRIBUTING.md) for details).
 
 ---
 

{tecio_python-0.3.0 → tecio_python-0.3.2}/README.md

@@ -38,6 +38,8 @@ export TECIO_LIB=/path/to/libtecio.dylib  # macOS
 
 ## Quick start
 
+Writing a file:
+
 ```python
 import tecio
 import numpy as np
@@ -46,7 +48,7 @@ x = np.linspace(0, 2 * np.pi, 100)
 y = np.sin(x)
 
 with tecio.open("sine.szplt", "w") as tec:
-    tec.write_ijk_zone(data=[x, y], variables=["x", "y"])
+    tec.write_ordered_zone(data=[x, y], variables=["x", "y"])
 ```
 
 Reading a file:
@@ -54,10 +56,10 @@ Reading a file:
 ```python
 with tecio.open("sine.szplt", "r") as tec:
     print(tec.variables)  # ['x', 'y']
-    x = tec.zone[0].variable[0].values
-    y = tec.zone[0].variable[1].values
+    x = tec.zones[0].variables[0].values
+    y = tec.zones[0].variables[1].values
     # or
-    x, y = tec.zone[0].get_array(["x", "y"])
+    x, y = tec.zones[0].get_array(["x", "y"])
 ```
 
 ## API
@@ -85,7 +87,7 @@ Supported formats:
 
 ## Contributing
 
-Contributions are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+Contributions are welcome (see [CONTRIBUTING.md](CONTRIBUTING.md) for details).
 
 ---
 

{tecio_python-0.3.0/tecio → tecio_python-0.3.2}/plugins/paraview/TecplotTecioReader.py

@@ -119,8 +119,12 @@ if _TECIO_FALLBACK_PATH and _TECIO_FALLBACK_PATH not in sys.path:
 
 try:
     import tecio
-    from tecio import TecplotFEZoneReader, TecplotOrderedZoneReader
-    from tecio.libtecio import ValueLocation, ZoneType
+    from tecio import (
+        TecplotFEZoneReader,
+        TecplotOrderedZoneReader,
+        ValueLocation,
+        ZoneType,
+    )
 
     _TECIO_IMPORT_ERROR: Exception | None = None
 except Exception as exc:  # pragma: no cover - environment-dependent  # noqa: BLE001
@@ -445,7 +449,7 @@ class TecplotReader(VTKPythonAlgorithmBase):
 
         self._zone_selection.RemoveAllArrays()
         self._zone_keys.clear()
-        for zone in reader.zone:
+        for zone in reader.zones:
             title = zone.title or f"Zone {zone.zone_index}"
             key = f"{zone.zone_index}: {title}"
             self._zone_keys[zone.zone_index] = key
@@ -673,7 +677,7 @@ class TecplotReader(VTKPythonAlgorithmBase):
         static/always-present geometry, so they're excluded from the time axis and
         instead included at every requested time (see :meth:`RequestData`).
         """
-        times = {zone.solution_time for zone in reader.zone if zone.strand_id != 0}
+        times = {zone.solution_time for zone in reader.zones if zone.strand_id != 0}
         return sorted(times)
 
     @smproperty.doublevector(
@@ -756,7 +760,7 @@ class TecplotReader(VTKPythonAlgorithmBase):
         self._add_variable_aux_field_data(output.GetFieldData(), reader)
 
         block_index = 0
-        for zone in reader.zone:
+        for zone in reader.zones:
             key = self._zone_keys.get(zone.zone_index)
             if key is not None and not self._zone_selection.ArrayIsEnabled(key):
                 continue
@@ -986,7 +990,7 @@ class TecplotReader(VTKPythonAlgorithmBase):
         n_points = dataset.GetNumberOfPoints()
         n_cells = dataset.GetNumberOfCells()
 
-        for var in zone.variable:
+        for var in zone.variables:
             if not self._array_selection.ArrayIsEnabled(var.name):
                 continue
             values = var.values
@@ -1035,7 +1039,7 @@ class TecplotReader(VTKPythonAlgorithmBase):
             if name is None:
                 flat_components.append(None)
                 continue
-            var = zone.variable[name]
+            var = zone.variables[name]
             values = var.values
             if values is None:  # passive, or absent in this specific zone
                 flat_components.append(None)

{tecio_python-0.3.0 → tecio_python-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tecio-python"
-version = "0.3.0"
+version = "0.3.2"
 description = "Python interface for reading and writing Tecplot data files"
 
 readme = "README.md"
@@ -69,6 +69,9 @@ mat = ["scipy"]
 include = ["tecio*"]
 exclude = ["archive*", "test*"]
 
+[tool.setuptools.data-files]
+"share/tecio/plugins/paraview" = ["plugins/paraview/TecplotTecioReader.py"]
+
 [tool.ruff]
 line-length = 88
 target-version = "py310"
@@ -109,7 +112,7 @@ python-version = "3.11"
 output-format = "concise"
 
 [[tool.ty.overrides]]
-include = ["tecio/plugins/**"]
+include = ["plugins/**"]
 
 [tool.ty.overrides.rules]
 unresolved-import = "ignore"

{tecio_python-0.3.0 → tecio_python-0.3.2}/tecio/__init__.py

@@ -9,9 +9,22 @@ from importlib import metadata
 try:
     __version__ = metadata.version("tecio")
 except metadata.PackageNotFoundError:
-    __version__ = "0.3.0"
+    __version__ = "0.3.2"
 
 from . import cli, libtecio
+from ._constants import (
+    Boolean,
+    DataPacking,
+    DataType,
+    Debug,
+    FaceNeighborMode,
+    FeCellShape,
+    FileFormat,
+    FileType,
+    ValueLocation,
+    VarStatus,
+    ZoneType,
+)
 from ._containers import VariableList, ZoneList
 from ._dat_read import TecplotDatReader
 from ._dat_write import TecplotDatWriter
@@ -33,11 +46,11 @@ from ._writer import TecplotWriter
 # Ensure these display as their canonical public name in docs and help(),
 # rather than the private module they're actually defined in.
 open.__module__ = "tecio"
-AppendWrite.__module__ = "tecio"
-AppendReadWrite.__module__ = "tecio"
-ZoneList.__module__ = "tecio"
-VariableList.__module__ = "tecio"
 for _cls in (
+    AppendWrite,
+    AppendReadWrite,
+    ZoneList,
+    VariableList,
     TecplotReader,
     TecplotZoneReader,
     TecplotOrderedZoneReader,
@@ -51,6 +64,17 @@ for _cls in (
     TecplotSzlWriter,
     TecplotPltWriter,
     TecplotDatWriter,
+    Boolean,
+    DataPacking,
+    DataType,
+    Debug,
+    FaceNeighborMode,
+    FeCellShape,
+    FileFormat,
+    FileType,
+    ValueLocation,
+    VarStatus,
+    ZoneType,
 ):
     _cls.__module__ = "tecio"
 del _cls
@@ -76,5 +100,32 @@ __all__ = [
     "TecplotSzlWriter",
     "TecplotPltWriter",
     "TecplotDatWriter",
-    "__version__",
+    "Boolean",
+    "DataPacking",
+    "DataType",
+    "Debug",
+    "FaceNeighborMode",
+    "FeCellShape",
+    "FileFormat",
+    "FileType",
+    "ValueLocation",
+    "VarStatus",
+    "ZoneType",
 ]
+
+_STANDARD_MODULE_ATTRIBUTES = (
+    "__name__",
+    "__file__",
+    "__path__",
+    "__doc__",
+    "__all__",
+    "__package__",
+    "__version__",
+    "__cached__",
+    "__spec__",
+)
+
+
+# Only public API visible to user
+def __dir__() -> list:
+    return sorted((*_STANDARD_MODULE_ATTRIBUTES, *__all__))

tecio_python-0.3.2/tecio/_constants.py

@@ -0,0 +1,345 @@
+"""Tecplot meaningful integers.
+
+The TecIO library often uses integers with special meanings (zone types, data types,
+data locations). The same values are used both for writing (``tec*142`` functions) and
+for SZL reading and writing (``tec_*`` functions). Where available, the equivalent
+keyword used in Tecplot ASCII files is exposed as a class property, returning the
+corresponding int value.
+"""
+
+from __future__ import annotations
+
+from enum import Enum
+
+__all__ = [
+    "Boolean",
+    "DataPacking",
+    "DataType",
+    "Debug",
+    "FaceNeighborMode",
+    "FeCellShape",
+    "FileFormat",
+    "FileType",
+    "ValueLocation",
+    "VarStatus",
+    "ZoneType",
+]
+
+
+class FileFormat(Enum):
+    """Binary data format selector.
+
+    .. list-table::
+       :header-rows: 1
+       :widths: 25 10 65
+
+       * - Attribute
+         - Value
+         - Description
+       * - ``PLT``
+         - ``0``
+         - Classic PLT binary format.
+       * - ``SZPLT``
+         - ``1``
+         - SZL subzone-loadable format.
+    """
+
+    PLT = 0
+    SZPLT = 1
+
+
+class FileType(Enum):
+    """Tecplot file type.
+
+    .. list-table::
+       :header-rows: 1
+       :widths: 25 10 65
+
+       * - Attribute
+         - Value
+         - Description
+       * - ``FULL``
+         - ``0``
+         - Contains both grid and solution data.
+       * - ``GRID``
+         - ``1``
+         - Grid coordinates only.
+       * - ``SOLUTION``
+         - ``2``
+         - Solution variables only.
+    """
+
+    FULL = 0
+    GRID = 1
+    SOLUTION = 2
+
+
+class ZoneType(Enum):
+    """Tecplot zone type.
+
+    .. list-table::
+       :header-rows: 1
+       :widths: 25 10 65
+
+       * - Attribute
+         - Value
+         - Description
+       * - ``ORDERED``
+         - ``0``
+         - Structured IJK grid.
+       * - ``FELINESEG``
+         - ``1``
+         - Finite-element line segments.
+       * - ``FETRIANGLE``
+         - ``2``
+         - Finite-element triangles.
+       * - ``FEQUADRILATERAL``
+         - ``3``
+         - Finite-element quadrilaterals.
+       * - ``FETETRAHEDRON``
+         - ``4``
+         - Finite-element tetrahedra.
+       * - ``FEBRICK``
+         - ``5``
+         - Finite-element hexahedra.
+       * - ``FEPOLYGON``
+         - ``6``
+         - Finite-element polygons (face-based).
+       * - ``FEPOLYHEDRON``
+         - ``7``
+         - Finite-element polyhedra (face-based).
+       * - ``FEMIXED``
+         - ``8``
+         - Mixed finite-element types.
+    """
+
+    ORDERED = 0
+    FELINESEG = 1
+    FETRIANGLE = 2
+    FEQUADRILATERAL = 3
+    FETETRAHEDRON = 4
+    FEBRICK = 5
+    FEPOLYGON = 6
+    FEPOLYHEDRON = 7
+    FEMIXED = 8
+
+
+class FeCellShape(Enum):
+    """Unstructured cell shape category.
+
+    .. list-table::
+       :header-rows: 1
+       :widths: 25 10 65
+
+       * - Attribute
+         - Value
+         - Description
+       * - ``BAR``
+         - ``0``
+         - 2D two-node element.
+       * - ``TRIANGLE``
+         - ``1``
+         - 2D three-node element.
+       * - ``QUADRILATERAL``
+         - ``2``
+         - 2D four-node element.
+       * - ``TETRAHEDRON``
+         - ``3``
+         - 3D four-node element.
+       * - ``HEXAHEDRON``
+         - ``4``
+         - 3D six-node element.
+       * - ``PYRAMID``
+         - ``5``
+         - 3D five-node element.
+       * - ``PRISM``
+         - ``6``
+         - 3D eight-node element.
+    """
+
+    BAR = 0
+    TRIANGLE = 1
+    QUADRILATERAL = 2
+    TETRAHEDRON = 3
+    HEXAHEDRON = 4
+    PYRAMID = 5
+    PRISM = 6
+
+
+class FaceNeighborMode(Enum):
+    """Boundary face-sharing mode between zones.
+
+    .. list-table::
+       :header-rows: 1
+       :widths: 35 10 55
+
+       * - Attribute
+         - Value
+         - Description
+       * - ``LOCAL_ONE_TO_ONE``
+         - ``0``
+         - Each face has at most one local neighbor.
+       * - ``LOCAL_ONE_TO_MANY``
+         - ``1``
+         - Each face may have multiple local neighbors (hanging nodes).
+       * - ``GLOBAL_ONE_TO_ONE``
+         - ``2``
+         - Each face has at most one neighbor in any zone.
+       * - ``GLOBAL_ONE_TO_MANY``
+         - ``3``
+         - Each face may have multiple neighbors in any zone (hanging nodes).
+    """
+
+    LOCAL_ONE_TO_ONE = 0
+    LOCAL_ONE_TO_MANY = 1
+    GLOBAL_ONE_TO_ONE = 2
+    GLOBAL_ONE_TO_MANY = 3
+
+
+class ValueLocation(Enum):
+    """Data value location within a cell.
+
+    .. list-table::
+       :header-rows: 1
+       :widths: 25 10 65
+
+       * - Attribute
+         - Value
+         - Description
+       * - ``CELL_CENTERED``
+         - ``0``
+         - Values stored at cell centres.
+       * - ``NODAL``
+         - ``1``
+         - Values stored at grid nodes.
+    """
+
+    CELL_CENTERED = 0
+    NODAL = 1
+
+
+class DataPacking(Enum):
+    """Zone data packing order for ASCII (``.dat``) files.
+
+    Controls whether data is laid out variable-by-variable or point-by-point
+    in the ASCII file. The ``DATAPACKING`` keyword in a zone header takes one
+    of these two values.
+
+    .. list-table::
+       :header-rows: 1
+       :widths: 25 10 65
+
+       * - Attribute
+         - Value
+         - Description
+       * - ``POINT``
+         - ``0``
+         - One row per node/cell containing all variable values.
+       * - ``BLOCK``
+         - ``1``
+         - One contiguous block per variable containing all node/cell values.
+           Tecplot default; faster for variable-at-a-time access patterns.
+    """
+
+    POINT = 0
+    BLOCK = 1
+
+
+class DataType(Enum):
+    """On-disk storage type for variable data.
+
+    .. list-table::
+       :header-rows: 1
+       :widths: 25 10 65
+
+       * - Attribute
+         - Value
+         - Description
+       * - ``FLOAT``
+         - ``1``
+         - 32-bit IEEE floating point.
+       * - ``DOUBLE``
+         - ``2``
+         - 64-bit IEEE floating point.
+       * - ``INT32``
+         - ``3``
+         - 32-bit signed integer.
+       * - ``INT16``
+         - ``4``
+         - 16-bit signed integer.
+       * - ``BYTE``
+         - ``5``
+         - 8-bit unsigned integer.
+    """
+
+    FLOAT = 1
+    DOUBLE = 2
+    INT32 = 3
+    INT16 = 4
+    BYTE = 5
+
+
+class VarStatus(Enum):
+    """Variable active/passive flag.
+
+    .. list-table::
+       :header-rows: 1
+       :widths: 25 10 65
+
+       * - Attribute
+         - Value
+         - Description
+       * - ``ACTIVE``
+         - ``0``
+         - Variable has data in this zone.
+       * - ``PASSIVE``
+         - ``1``
+         - Variable has no data in this zone.
+    """
+
+    ACTIVE = 0
+    PASSIVE = 1
+
+
+class Boolean(Enum):
+    """Boolean flag for C function arguments.
+
+    .. list-table::
+       :header-rows: 1
+       :widths: 25 10 65
+
+       * - Attribute
+         - Value
+         - Description
+       * - ``FALSE``
+         - ``0``
+         - Logical false.
+       * - ``TRUE``
+         - ``1``
+         - Logical true.
+    """
+
+    FALSE = 0
+    TRUE = 1
+
+
+class Debug(Enum):
+    """Debug flag for C function arguments.
+
+    .. list-table::
+       :header-rows: 1
+       :widths: 25 10 65
+
+       * - Attribute
+         - Value
+         - Description
+       * - ``FALSE``
+         - ``0``
+         - Debug output disabled.
+       * - ``TRUE``
+         - ``1``
+         - Debug output enabled.
+    """
+
+    FALSE = 0
+    TRUE = 1