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.2

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.2
File Size Uploaded Provenance Actions
tecio_python-0.4.2.tar.gz 370.1 kB With provenance Details for tecio_python-0.4.2.tar.gz

Built distribution (wheel)

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

Total release size: 670.7 kB

Release files / tecio_python-0.4.2.tar.gz

Download URL tecio_python-0.4.2.tar.gz
Size 370.1 kB
Tags Source
SHA-256 checksum
How to use checksums
a488a752772bcdececa8f8cf1f56a71779840376447f0050c5d2b6ac2baaa233
BLAKE2b-256 checksum
How to use checksums
cabc7bce608e3b99fae891eb820f698d2d90f692495c1500e6839979f4493d35
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 16, 2026.

Transparency log

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

Download URL tecio_python-0.4.2-py3-none-any.whl
Size 300.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
44f34f78a3993de11387ed0405ea17de1ec015d470f1617f227e1087e7f39b63
BLAKE2b-256 checksum
How to use checksums
5c41656c925d6352fe6db124117508a9bf2175a7186ddf54545d7c741b0cc23d
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 16, 2026.

Transparency log

Security for tecio-python 0.4.2

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.2.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 16, 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