Skip to main content

tecio

License CI Codecov Docs PyPI Python

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

Writing a file:

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_ordered_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.zones[0].variables[0].values
    y = tec.zones[0].variables[1].values
    # or
    x, y = tec.zones[0].get_array(["x", "y"])

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


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 separatly aquiring the source code or compiled binaries from Tecplot, Inc.

Metadata

Release files for tecio-python 0.4.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tecio-python 0.4.3
File Size Uploaded Provenance Actions
tecio_python-0.4.3.tar.gz 390.2 kB With provenance Details for tecio_python-0.4.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tecio-python 0.4.3
File Interpreter ABI Platform Actions
tecio_python-0.4.3-py3-none-any.whl Python 3 none any Details for tecio_python-0.4.3-py3-none-any.whl

Total release size: 703.4 kB

Release files / tecio_python-0.4.3.tar.gz

Download URL tecio_python-0.4.3.tar.gz
Size 390.2 kB
Tags Source
SHA-256 checksum
How to use checksums
1493cca43c72a49037e75a2dcdc0c5c6bca6dde8b55ce6cab996cd03df8162c0
BLAKE2b-256 checksum
How to use checksums
25a4e792f4aba2dfaad108d31872f906a786aa300223a1cb51df84e7ce0c9ed5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / tecio_python-0.4.3-py3-none-any.whl

Download URL tecio_python-0.4.3-py3-none-any.whl
Size 313.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0f2e14ae21fc9b2a73cbc9d357c6c678261ebf26cc28d0f96062fdef4a14aaf5
BLAKE2b-256 checksum
How to use checksums
3bda8f64da82a7fa973f60607c4330cce4c1a83c70dba9d845b9a9ec86a9a42e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Security for tecio-python 0.4.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for tecio_python-0.4.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page