tecio-python 0.1.0

Python interface for reading and writing Tecplot data files

tecio

Python interface for reading and writing Tecplot data files.

Overview

tecio wraps Tecplot's TecIO C library to provide a Python API for reading and writing Tecplot binary formats (.szplt, .plt) and ASCII (.dat). It also includes command-line tools for common file operations such as converting formats, extracting zones, and computing statistics.

Requirements: Python 3.10+, NumPy, Tecplot 360 (or the standalone TecIO library)

---

Installation

pip install tecio-python

The TecIO shared library (libtecio.so / libtecio.dylib) is not bundled with this package and must be provided separately via a Tecplot 360 installation or the standalone TecIO library. Set the TECIO_LIB environment variable to point to the library if it is not on your system path:

export TECIO_LIB=/path/to/libtecio.so     # Linux
export TECIO_LIB=/path/to/libtecio.dylib  # macOS

Quick start

import tecio
import numpy as np

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"])

Reading a file:

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

API

All file access goes through tecio.open, which selects the correct format handler from the file extension and returns a context manager:

Mode	Description
"r"	Read an existing file
"w"	Write a new file
"x"	Write, failing if the file already exists
"a"	Append new zones to an existing file
"a+"	Append and read in the same session

Supported formats:

Extension	Format
.szplt	Tecplot SZL binary (subzone-loadable)
.plt / .bin	Tecplot PLT binary
.dat / .tec	Tecplot ASCII

---

Contributing

Contributions are welcome — see CONTRIBUTING.md for details.

---

References

• Tecplot data format specification
• TecIO library
• Full documentation

---

Disclaimer

This project is an independent open source library and is not affiliated with, endorsed by, or supported by Tecplot, Inc. in any way. Tecplot and TecIO are trademarks of Tecplot, Inc. Use of the TecIO library requires a separate license from Tecplot, Inc.